此版本仍在开发中，尚未被视为稳定版本。如需使用最新稳定版本，请访问 Spring Data Redis 4.0.4！spring-doc.cadn.net.cn

迁移指南

本节包含有关迁移步骤、弃用和移除的详细信息。spring-doc.cadn.net.cn

从 2.x 升级到 3.x

已移除的类型

类型	替换
o.s.d.redis.Versionspring-doc.cadn.net.cn	o.s.d.util.Versionspring-doc.cadn.net.cn
o.s.d.redis.VersionParserspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.RedisZSetCommands.Aggregatespring-doc.cadn.net.cn	o.s.d.redis.connection.zset.Aggregatespring-doc.cadn.net.cn
o.s.d.redis.connection.RedisZSetCommands.Tuplespring-doc.cadn.net.cn	o.s.d.redis.connection.zset.Tuplespring-doc.cadn.net.cn
o.s.d.redis.connection.RedisZSetCommands.Weightsspring-doc.cadn.net.cn	o.s.d.redis.connection.zset.Weightsspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisZSetCommands.Rangespring-doc.cadn.net.cn	o.s.d.domain.Rangespring-doc.cadn.net.cn
o.s.d.redis.connection.RedisZSetCommands.Limitspring-doc.cadn.net.cn	o.s.d.redis.connection.Limit.javaspring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisUtilsspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisVersionUtilspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.core.convert.CustomConversionsspring-doc.cadn.net.cn	o.s.d.convert.CustomConversionsspring-doc.cadn.net.cn

类型

替换

o.s.d.redis.Versionspring-doc.cadn.net.cn

o.s.d.util.Versionspring-doc.cadn.net.cn

o.s.d.redis.VersionParserspring-doc.cadn.net.cn

-spring-doc.cadn.net.cn

o.s.d.redis.connection.RedisZSetCommands.Aggregatespring-doc.cadn.net.cn

o.s.d.redis.connection.zset.Aggregatespring-doc.cadn.net.cn

o.s.d.redis.connection.RedisZSetCommands.Tuplespring-doc.cadn.net.cn

o.s.d.redis.connection.zset.Tuplespring-doc.cadn.net.cn

o.s.d.redis.connection.RedisZSetCommands.Weightsspring-doc.cadn.net.cn

o.s.d.redis.connection.zset.Weightsspring-doc.cadn.net.cn

o.s.d.redis.connection.RedisZSetCommands.Rangespring-doc.cadn.net.cn

o.s.d.domain.Rangespring-doc.cadn.net.cn

o.s.d.redis.connection.RedisZSetCommands.Limitspring-doc.cadn.net.cn

o.s.d.redis.connection.Limit.javaspring-doc.cadn.net.cn

o.s.d.redis.connection.jedis.JedisUtilsspring-doc.cadn.net.cn

-spring-doc.cadn.net.cn

o.s.d.redis.connection.jedis.JedisVersionUtilspring-doc.cadn.net.cn

-spring-doc.cadn.net.cn

o.s.d.redis.core.convert.CustomConversionsspring-doc.cadn.net.cn

o.s.d.convert.CustomConversionsspring-doc.cadn.net.cn

已更改的方法和类型

表1. 核心
类型	方法	替换
o.s.d.redis.core.Cursorspring-doc.cadn.net.cn	打开spring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.core.RedisTemplatespring-doc.cadn.net.cn	执行spring-doc.cadn.net.cn	doWithKeysspring-doc.cadn.net.cn
o.s.d.redis.stream.StreamMessageListenerContainerspring-doc.cadn.net.cn	isAutoAckspring-doc.cadn.net.cn	isAutoAcknowledgespring-doc.cadn.net.cn
o.s.d.redis.stream.StreamMessageListenerContainerspring-doc.cadn.net.cn	autoAckspring-doc.cadn.net.cn	自动确认spring-doc.cadn.net.cn

表2. Redis连接
类型	方法	替换
o.s.d.redis.connection.ClusterCommandExecutionFailureExceptionspring-doc.cadn.net.cn	getCausespring-doc.cadn.net.cn	getSuppressedspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisConnectionspring-doc.cadn.net.cn	bgWriteAofspring-doc.cadn.net.cn	bgReWriteAofspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisConnectionspring-doc.cadn.net.cn	slaveOfspring-doc.cadn.net.cn	replicaOfspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisConnectionspring-doc.cadn.net.cn	取消主从关系spring-doc.cadn.net.cn	replicaOfNoOnespring-doc.cadn.net.cn
o.s.d.redis.connection.ReactiveClusterCommandsspring-doc.cadn.net.cn	clusterGetSlavesspring-doc.cadn.net.cn	clusterGetReplicasspring-doc.cadn.net.cn
o.s.d.redis.connection.ReactiveClusterCommandsspring-doc.cadn.net.cn	clusterGetMasterSlaveMapspring-doc.cadn.net.cn	clusterGetMasterReplicaMapspring-doc.cadn.net.cn
o.s.d.redis.connection.ReactiveKeyCommandsspring-doc.cadn.net.cn	getNewNamespring-doc.cadn.net.cn	获取新密钥spring-doc.cadn.net.cn
o.s.d.redis.connection.RedisClusterNode.Flagspring-doc.cadn.net.cn	从节点spring-doc.cadn.net.cn	副本spring-doc.cadn.net.cn
o.s.d.redis.connection.RedisClusterNode.Builderspring-doc.cadn.net.cn	slaveOfspring-doc.cadn.net.cn	replicaOfspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisNodespring-doc.cadn.net.cn	isSlavespring-doc.cadn.net.cn	isReplicaspring-doc.cadn.net.cn
o.s.d.redis.connection.RedisSentinelCommandsspring-doc.cadn.net.cn	从属节点spring-doc.cadn.net.cn	副本spring-doc.cadn.net.cn
o.s.d.redis.connection.RedisServerspring-doc.cadn.net.cn	getNumberSlavesspring-doc.cadn.net.cn	获取副本数量spring-doc.cadn.net.cn
o.s.d.redis.connection.RedisServerCommandsspring-doc.cadn.net.cn	slaveOfspring-doc.cadn.net.cn	replicaOfspring-doc.cadn.net.cn
o.s.d.redis.core.ClusterOperationsspring-doc.cadn.net.cn	getSlavesspring-doc.cadn.net.cn	getReplicasspring-doc.cadn.net.cn
o.s.d.redis.core.RedisOperationsspring-doc.cadn.net.cn	slaveOfspring-doc.cadn.net.cn	replicaOfspring-doc.cadn.net.cn

表3. Redis 操作
类型	方法	替换
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	geoAddspring-doc.cadn.net.cn	添加spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	geoDistspring-doc.cadn.net.cn	距离spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	geoHashspring-doc.cadn.net.cn	哈希spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	geoPosspring-doc.cadn.net.cn	位置spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	geoRadiusspring-doc.cadn.net.cn	半径spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	geoRadiusByMemberspring-doc.cadn.net.cn	半径spring-doc.cadn.net.cn
o.s.d.redis.core.GeoOperations & BoundGeoOperationsspring-doc.cadn.net.cn	geoRemovespring-doc.cadn.net.cn	移除spring-doc.cadn.net.cn

表4. Redis缓存
类型	方法	替换
o.s.d.redis.cache.RedisCacheConfigurationspring-doc.cadn.net.cn	为键添加前缀spring-doc.cadn.net.cn	使用前缀缓存名称spring-doc.cadn.net.cn
o.s.d.redis.cache.RedisCacheConfigurationspring-doc.cadn.net.cn	getKeyPrefixspring-doc.cadn.net.cn	getKeyPrefixForspring-doc.cadn.net.cn

Jedis

请阅读 Jedis 升级指南，其中涵盖了重要的驱动程序变更。spring-doc.cadn.net.cn

表5. Jedis Redis 连接
类型	方法	替换
o.s.d.redis.connection.jedis.JedisConnectionFactoryspring-doc.cadn.net.cn	getShardInfospring-doc.cadn.net.cn	可通过 JedisClientConfiguration 获取spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConnectionFactoryspring-doc.cadn.net.cn	设置分片信息spring-doc.cadn.net.cn	可通过 JedisClientConfiguration 进行设置spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConnectionFactoryspring-doc.cadn.net.cn	创建集群spring-doc.cadn.net.cn	现在需要一个 `Connection` 实例，而不是 `Jedis` 实例spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConvertersspring-doc.cadn.net.cn		现在具有包级可见性spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConvertersspring-doc.cadn.net.cn	tuplesToTuplesspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConvertersspring-doc.cadn.net.cn	tuplesToTuplesspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConvertersspring-doc.cadn.net.cn	stringListToByteListspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConvertersspring-doc.cadn.net.cn	stringSetToByteSetspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConvertersspring-doc.cadn.net.cn	stringMapToByteMapspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConvertersspring-doc.cadn.net.cn	tupleSetToTupleSetspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConvertersspring-doc.cadn.net.cn	toTupleSetspring-doc.cadn.net.cn	-spring-doc.cadn.net.cn
o.s.d.redis.connection.jedis.JedisConvertersspring-doc.cadn.net.cn	toDataAccessExceptionspring-doc.cadn.net.cn	o.s.d.redis.connection.jedis.JedisExceptionConverter#convertspring-doc.cadn.net.cn

事务 / 管道化

流水线（Pipelining）和事务（Transactions）现在互斥。在流水线/事务模式下，不再允许使用服务器或连接命令。spring-doc.cadn.net.cn

Lettuce

Lettuce 连接池

LettucePool 及其实现类 DefaultLettucePool 已被移除，且没有替代方案。请参阅驱动程序文档以了解驱动程序原生的连接池功能。接受连接池参数的方法已更新。这影响了 LettuceConnectionFactory 和 LettuceConnection 上的方法。spring-doc.cadn.net.cn

Lettuce 认证

AuthenticatingRedisClient 已被移除，且无替代方案。请参阅驱动程序文档中关于 RedisURI 的部分，以设置认证数据。spring-doc.cadn.net.cn