HTTPoison在Docker容器间通信出现NXDOMAIN错误的排查与解决

问题背景

在使用Elixir的HTTPoison库进行Docker容器间通信时，开发者遇到了一个典型的问题：当尝试访问同一Docker网络中的CouchDB服务时，HTTPoison返回了:nxdomain错误，而使用Req和Finch等其他HTTP客户端却能正常工作。这个问题在升级了项目依赖和Docker基础镜像后突然出现。

现象分析

具体表现为：

• 使用HTTPoison访问http://couchdb:5984时返回:nxdomain错误
• 使用Req和Finch访问相同地址却能正常返回200状态码
• 直接使用容器IP地址http://172.20.0.3:5984也能正常工作

通过Docker网络检查确认：

• 应用容器和CouchDB容器确实在同一网络my_app_default中
• 容器间通过DNS名称couchdb可以正确解析到IP172.20.0.3

深入排查

进一步使用Elixir的底层网络功能验证：

1. 使用:inet_res.resolve/3函数能成功解析couchdb域名
2. 使用:inet.getaddrs/2也能正确返回IP地址

这表明问题不在于DNS解析本身，而是HTTPoison底层使用的hackney库在处理DNS解析时出现了问题。

问题根源

这个问题实际上与hackney库的一个已知问题有关。在某些情况下，hackney在处理容器间的DNS解析时会错误地返回NXDOMAIN（不存在的域名）错误，即使域名能够正常解析。

解决方案

目前有两种可行的解决方案：

1. 临时解决方案：显式指定hackney的版本为1.20.1

{:hackney, "~> 1.20.1", override: true}

2. 长期解决方案：考虑迁移到更现代的HTTP客户端库，如Req或Finch，这些库使用了不同的底层实现，不受此问题影响。

技术建议

对于在Docker环境中使用Elixir进行服务间通信的开发人员，建议：

1. 在遇到类似DNS解析问题时，首先验证基础网络功能是否正常
2. 考虑使用IP地址作为临时解决方案
3. 关注依赖库的版本更新，特别是网络相关的底层库
4. 评估是否需要切换到更活跃维护的HTTP客户端库

这个问题很好地展示了在容器化环境中服务间通信可能遇到的微妙问题，也提醒我们在依赖管理时需要更加谨慎，特别是在升级关键依赖时。