網(wǎng)站做蜘蛛池有用嗎,營銷型網(wǎng)站有哪些建設(shè)流程,鞏義市建設(shè)局網(wǎng)站,可以做駕校推廣的網(wǎng)站本文的核心讀者是 SpringBoot 初學(xué)者、后端開發(fā)工程師#xff0c;以及在項(xiàng)目中遇到 “配置遠(yuǎn)程 Redis 后仍連接 localhost” 問題的技術(shù)人員。將為你解決以下實(shí)際問題#xff1a; 明明配置了 spring.redis.host 遠(yuǎn)程地址#xff0c;項(xiàng)目卻始終使用默認(rèn) localhost:6379 連接…本文的核心讀者是 SpringBoot 初學(xué)者、后端開發(fā)工程師以及在項(xiàng)目中遇到“配置遠(yuǎn)程 Redis 后仍連接 localhost”問題的技術(shù)人員。將為你解決以下實(shí)際問題明明配置了spring.redis.host遠(yuǎn)程地址項(xiàng)目卻始終使用默認(rèn)localhost:6379連接用 Jedis 能直接連接遠(yuǎn)程 Redis但 SpringBoot 集成時失敗不清楚 SpringBoot Redis 自動配置邏輯無法定位配置失效原因。二、核心前提SpringBoot Redis 自動配置邏輯解析要解決連接失敗問題必須先理解 SpringBoot 對 Redis 的自動配置規(guī)則。Redis 相關(guān)的核心自動配置類是RedisAutoConfiguration包路徑org.springframework.boot.autoconfigure.data.redis其工作原理如下該類會掃描配置文件中spring.redis.*前綴的配置項(xiàng)自動創(chuàng)建RedisConnectionFactory、RedisTemplate等核心 Bean關(guān)鍵邏輯只有當(dāng)spring.redis.host、spring.redis.port等關(guān)鍵配置項(xiàng)被顯式設(shè)置且有效時自動配置類才會使用自定義配置若配置項(xiàng)缺失或無效會觸發(fā)默認(rèn)值hostlocalhostport6379。我在 CentOS 7 服務(wù)器 SpringBoot 2.7.8 版本的項(xiàng)目中遇到了典型問題配置spring.redis.host192.168.1.100后項(xiàng)目啟動日志仍顯示 “Connecting to localhost:6379”。但通過 Jedis 客戶端直接連接192.168.1.100:6379卻能成功代碼如下這說明遠(yuǎn)程 Redis 服務(wù)本身正常問題出在 SpringBoot 配置或依賴層面。// 測試 Jedis 直接連接遠(yuǎn)程 Redis成功代碼作者張三2024-05publicclassJedisDirectTest{publicstaticvoidmain(String[]args){// 遠(yuǎn)程 Redis 地址與端口JedisjedisnewJedis(192.168.1.100,6379);// 若 Redis 有密碼需添加認(rèn)證我的 Redis 密碼為 123456jedis.auth(123456);// 測試連接返回 PONG 說明連接成功System.out.println(Jedis 連接測試jedis.ping());jedis.close();}}三、三步排查從配置到服務(wù)的全流程解決1. 第一步排查配置文件有效性 —— 優(yōu)先級與格式陷阱很多開發(fā)者會忽略“多配置文件沖突”問題。我當(dāng)時的項(xiàng)目中同時存在application.properties和application.yml兩個配置文件具體配置如下問題配置示例application.yml期望的遠(yuǎn)程配置spring:redis:host:192.168.1.100# 遠(yuǎn)程 Redis 地址port:6379password:123456timeout:3000# 連接超時時間單位毫秒application.properties隱藏的沖突配置# 該配置覆蓋了 yml 中的遠(yuǎn)程地址 spring.redis.hostlocalhost關(guān)鍵知識點(diǎn)SpringBoot 配置加載優(yōu)先級在未指定 profile 的情況下同一配置項(xiàng)properties 文件優(yōu)先級高于 yml 文件。因此即使 yml 配置了遠(yuǎn)程地址最終生效的仍是 properties 中的localhost。解決辦法方案 1刪除application.properties中沖突的spring.redis.host配置方案 2統(tǒng)一使用application.yml推薦結(jié)構(gòu)更清晰刪除冗余的 properties 文件。驗(yàn)證配置是否生效修改后啟動項(xiàng)目查看日志中RedisAutoConfiguration相關(guān)輸出若出現(xiàn)以下日志說明配置已被識別2024-05-20 14:30:00.123 INFO 12345 --- [main] o.s.b.a.redis.RedisAutoConfiguration : Using redis host: 192.168.1.1002. 第二步排查依賴沖突 —— Lettuce 與 Jedis 客戶端選擇SpringBoot 2.x 及以上版本中spring-boot-starter-data-redis依賴默認(rèn)引入Lettuce客戶端而非 Jedis。若項(xiàng)目中同時引入 Jedis 依賴且版本不兼容會導(dǎo)致RedisConnectionFactory創(chuàng)建失敗進(jìn)而 fallback 到默認(rèn)配置。問題依賴示例pom.xml!-- 默認(rèn)引入 Lettuce 客戶端 --dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-data-redis/artifactId/dependency!-- 額外引入 Jedis 3.0.0 版本與 SpringBoot 2.7.8 不兼容 --dependencygroupIdredis.clients/groupIdartifactIdjedis/artifactIdversion3.0.0/version/dependency解決辦法統(tǒng)一客戶端方案 1使用默認(rèn) Lettuce 客戶端推薦刪除多余的 Jedis 依賴僅保留spring-boot-starter-data-redis配置文件無需額外修改Lettuce 連接池配置可選spring:redis:host:192.168.1.100port:6379password:123456lettuce:# Lettuce 連接池配置可選pool:max-active:8max-idle:8min-idle:2max-wait:-1ms方案 2顯式使用 Jedis 客戶端若項(xiàng)目必須使用 Jedis需排除 Lettuce 依賴并確保 Jedis 版本與 SpringBoot 兼容建議省略版本號由 SpringBoot 自動管理dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-data-redis/artifactIdexclusions!-- 排除默認(rèn)的 Lettuce 依賴 --exclusiongroupIdio.lettuce/groupIdartifactIdlettuce-core/artifactId/exclusion/exclusions/dependency!-- 引入 Jedis 依賴版本由 SpringBoot 自動管理作者張三 --dependencygroupIdredis.clients/groupIdartifactIdjedis/artifactId/dependency3. 第三步排查 Redis 服務(wù)遠(yuǎn)程訪問權(quán)限即使 SpringBoot 配置正確若遠(yuǎn)程 Redis 服務(wù)限制了訪問仍會連接失敗。需檢查以下兩個關(guān)鍵點(diǎn)1. Redis 配置文件redis.conf的 bind 地址問題配置bind 127.0.0.1僅允許本地訪問遠(yuǎn)程連接被拒絕解決配置修改為bind 0.0.0.0允許所有 IP 訪問或指定 SpringBoot 項(xiàng)目所在服務(wù)器的 IP如bind 192.168.1.200。修改后需重啟 Redis 服務(wù)CentOS 命令# 停止 Redissystemctl stop redis# 啟動 Redissystemctl start redis2. 服務(wù)器防火墻端口開放以 CentOS 7 為例Redis 默認(rèn)端口為 6379需確保防火墻開放該端口# 查看 6379 端口是否開放返回 yes 為開放firewall-cmd --query-port6379/tcp# 若未開放執(zhí)行以下命令開放端口--permanent 表示永久生效firewall-cmd --add-port6379/tcp --permanent# 重啟防火墻使配置生效firewall-cmd --reload3. Redis 密碼認(rèn)證可選但重要若 Redis 配置了密碼redis.conf 中requirepass 123456SpringBoot 配置文件必須添加spring.redis.password123456否則會因認(rèn)證失敗導(dǎo)致連接被拒絕。四、驗(yàn)證配置編寫測試接口確認(rèn)連接排查完成后通過以下測試接口驗(yàn)證 SpringBoot 是否成功連接遠(yuǎn)程 Redis代碼包含作者簽名便于版權(quán)追溯/** * Redis 連接測試接口作者張三項(xiàng)目版本v1.0.0 * 功能通過 StringRedisTemplate 操作遠(yuǎn)程 Redis驗(yàn)證連接有效性 */RestControllerRequestMapping(/redis/test)publicclassRedisConnectionTestController{// 注入 SpringBoot 自動配置的 StringRedisTemplateAutowiredprivateStringRedisTemplatestringRedisTemplate;/** * 向遠(yuǎn)程 Redis 存入測試數(shù)據(jù) * return 操作結(jié)果 */GetMapping(/setTestKey)publicStringsetTestKey(){// 存入 keytestKeyvaluespringboot-redis-success過期時間 10 分鐘stringRedisTemplate.opsForValue().set(testKey,springboot-redis-success,10,TimeUnit.MINUTES);return遠(yuǎn)程 Redis 數(shù)據(jù)存入成功作者張三;}/** * 從遠(yuǎn)程 Redis 獲取測試數(shù)據(jù) * return 存儲的 value 值 */GetMapping(/getTestKey)publicStringgetTestKey(){// 從遠(yuǎn)程 Redis 獲取 keytestKey 的值StringvaluestringRedisTemplate.opsForValue().get(testKey);return遠(yuǎn)程 Redis 獲取結(jié)果(valuenull?未找到數(shù)據(jù):value);}}驗(yàn)證步驟啟動 SpringBoot 項(xiàng)目訪問http://項(xiàng)目IP:端口/redis/test/setTestKey返回 “遠(yuǎn)程 Redis 數(shù)據(jù)存入成功”登錄遠(yuǎn)程 Redis 服務(wù)器執(zhí)行redis-cli -h 192.168.1.100 -p 6379連接客戶端輸入get testKey若返回springboot-redis-success說明連接完全正常。五、總結(jié)本文從SpringBoot Redis 自動配置邏輯出發(fā)解決了“配置遠(yuǎn)程地址后仍連接 localhost”的核心問題核心排查路徑為配置文件優(yōu)先級 → 依賴沖突 → Redis 服務(wù)權(quán)限。實(shí)際開發(fā)中這類問題多由細(xì)節(jié)疏忽導(dǎo)致而非復(fù)雜底層問題按上述步驟排查即可快速解決。