一、问题现象
本地开发环境调用天地图地理编码接口请求正常，项目部署至Windows云服务器后，前端访问后端服务，间接调用天地图官方接口时程序抛出解析异常：
org.springframework.web.reactive.function.client.WebClientRequestException: Failed to resolve 'api.tianditu.gov.cn' [A(1)]
at org.springframework.web.reactive.function.client.ExchangeFunctions$DefaultExchangeFunction.lambda$wrapException$9(ExchangeFunctions.java:137)请求流转：前端页面 → Windows云服务器SpringBoot3.x后端 → 调用http://api.tianditu.gov.cn接口，程序无法完成域名解析，第三方接口调用直接失败。
二、报错根因分析
- 错误释义
Failed to resolve代表域名解析失败，Java程序无法把域名api.tianditu.gov.cn解析为对应公网IP地址。 - 环境差异诱因
- 本地设备DNS配置正常，域名解析与接口访问均可正常执行；
- Windows云服务器默认DNS服务异常，无法正常查询天地图域名对应的IP；
- 项目采用WebClient发起网络请求，依赖系统DNS完成地址寻址，解析中断直接造成请求失败。
- 问题范围界定
本次故障和业务代码漏洞、接口密钥权限、Nginx反向代理、防火墙端口拦截均无关，根源为服务器自身DNS解析链路异常。
三、解决方案：Hosts静态绑定IP（无系统改动，应急首选）
操作步骤
无需修改服务器DNS配置，通过本地域名强制映射绕过解析故障，快速恢复接口调用。
-
使用DNS在线解析工具，跨DNS节点查询，获取天地图可用IP：
116.205.76.86、116.205.76.122 -
以管理员权限打开系统Hosts文件
文件路径：C:\Windows\System32\drivers\etc\hosts -
在文件末尾追加域名与IP映射关系
116.205.76.86 api.tianditu.gov.cn
116.205.76.122 api.tianditu.gov.cn -
命令行刷新DNS缓存，校验连通性
ipconfig /flushdns
ping api.tianditu.gov.cn -
重启SpringBoot应用，重新调用接口即可恢复正常。
方案优劣
- 优点：不改动系统网络参数，无潜在负面影响，适合紧急修复业务
- 缺点：若官方域名IP发生变更，需要手动更新Hosts映射记录
四、问题总结与运维建议
- 线上出现域名解析类报错，优先排查服务器网络与DNS服务，不必优先排查业务代码；
- Windows云服务器自带DNS稳定性不足，对外公网接口业务，可切换阿里、114等公共DNS提升稳定性；
- 调用第三方接口可借助Nginx本地代理转发请求，屏蔽服务器网络环境差异，减少解析、防盗链、IP白名单类问题；
- 业务紧急故障场景，优先使用Hosts绑定IP方式处置，高效稳妥恢复服务。