You need to enable JavaScript to run this app. 如何在Redis连接中传入IPv6地址?Host name cannot be null报错排查
优惠活动
大模型
产品
解决方案
定价
更多

如何在Redis连接中传入IPv6地址?Host name cannot be null报错排查

问题根因

抛出"Host name cannot be null"错误的核心原因是URI解析逻辑对连接串的拆分不符合语法规则,最终无法提取到有效host值。
按照通用URI语法规范,host字段与端口字段通过单冒号做分隔,而IPv6地址本身由多段冒号分隔的十六进制字符组成,不做特殊包裹直接写在host位置时,解析器会将IPv6地址内部的冒号全部识别为host和端口的分隔标识,直接导致host解析结果为空。
对应的错误写法如下:

RedisClient redisClient = new RedisClient(RedisURI.create("redis://fe80::20c:29ff:fec5:a66b:6379"))
正确IPv6地址传入实现方式
  • 严格遵循URI语法结构,所有IPv6地址在Redis连接串中必须用方括号[]包裹,和后续端口号做明确分隔,标准连接串结构为redis://[<IPv6地址>]:<Redis端口号>
  • 针对示例中的IPv6地址,修正后的可正常解析的代码为:
// 正确写法:IPv6地址被方括号包裹,URI解析可准确识别host与端口
RedisURI redisUri = RedisURI.create("redis://[fe80::20c:29ff:fec5:a66b]:6379");
RedisClient redisClient = new RedisClient(redisUri);

注意:示例中fe80开头的地址属于链路本地IPv6地址,不支持跨网段路由,部分客户端版本在使用这类地址时还需要补充对应的本地网卡绑定标识,才能正常完成网络连接,这部分不影响URI解析的基础逻辑。

内容的提问来源于stack exchange,提问作者Anonymous Creator

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 08:36:07