Docker容器中FastAPI调用外部API出现域名解析错误排查

这个错误是DNS解析失败导致的——容器内部无法将外部API的主机名解析为对应IP地址，和你提供的Dockerfile本身无关（你的Dockerfile指令均正常），以下是排查和解决方法：

排查步骤 #

1. 进入运行中的容器，测试DNS解析能力

   # 进入容器
   docker exec -it <容器ID/名称> /bin/bash
   # 测试外部API主机名的解析
   nslookup <外部API主机名>
   

   如果返回** server can't find xxx: NXDOMAIN，说明容器无法解析该主机名。

2. 测试宿主机的解析能力
   在宿主机上执行同样的nslookup <外部API主机名>，如果宿主机能正常解析，说明Docker容器的DNS配置存在问题；如果宿主机也无法解析，那是外部API的主机名本身有误或网络路由问题。

解决方法 #

方法1：启动容器时指定DNS服务器 #

停止现有容器，重新启动时添加DNS参数，使用公共DNS（比如8.8.8.8）：

docker run -d --name fastapi-app --dns 8.8.8.8 -p 8000:8000 <你的镜像名称>

方法2：检查容器网络模式 #

默认的bridge模式下容器应能访问外部网络，如果仍有问题，可以临时用host模式排查（生产环境不推荐，会共享宿主机网络栈）：

docker run -d --name fastapi-app --network host <你的镜像名称>

启动后测试是否能正常调用外部API，若可行，说明是bridge模式下的DNS或路由配置问题。

方法3：确认外部API主机名正确性 #

检查FastAPI代码中调用外部API的主机名是否存在拼写错误（比如域名后缀、字符遗漏等），也可以在容器内用curl直接测试完整API地址：

curl -X POST <外部API完整URL>

内容的提问来源于stack exchange，提问作者EnergyBoy