Java调用天气API解析失败主因是DTO与JSON结构不匹配，需确认外层包装字段、字段名一致、用Integer接可能null值；控制台刷新用\r覆盖、禁用\n；获取城市需公网IP定位；jar包需设HTTP超时、处理SSL、防止主线程退出。
Java调用天气API返回JSON但解析失败
常见现象是拿到HTTP响应后，ObjectMapper抛JsonProcessingException，或字段全为null。根本原因通常是API返回结构和你写的DTO不匹配——比如高德/和风天气的now数据嵌套在result或data里，而你直接映射到顶层类。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 先用
curl或Postman请求API，确认真实返回结构（注意是否有外层包装字段） - DTO字段名必须和JSON key完全一致，或加
@JsonProperty("temp")显式声明 - 别用
int接可能为null的数值字段，改用Integer，否则反序列化直接报错 - 时区字段如
timezone常是字符串（如"Asia/Shanghai"），别误定义为int
Java控制台实现每5秒刷新一次且不滚屏
核心不是“重绘”，而是用回车符\r把光标拉回行首覆盖原内容。一旦用了\n或System.out.println()，必然换行滚屏。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 用
System.out.print("\r" + content)，结尾不加\n - 确保每次输出长度不小于上次（比如补空格），否则旧字符残留（例如“23℃”刷成“9℃”会留个“℃”）
- 刷新间隔用
Thread.sleep(5000)，别用Timer——它默认后台线程，关掉终端可能不退出 - Windows下某些IDE（如老版IntelliJ）对
\r支持差，优先用终端运行jar包验证
Java获取本地IP对应城市再查天气
不能依赖InetAddress.getLocalHost()——它返回的是内网地址（如192.168.x.x），没地理信息。得走公网IP定位服务。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 先调用
https://api.ipify.org（纯文本返回公网IP）或https://httpbin.org/ip - 再拿这个IP去查地理位置，推荐和风天气的
/v7/ip接口（需key），或免费的ip-api.com/json/{ip} - 注意
ip-api.com有每分钟45次请求限制，开发时加Thread.sleep(1300)防被封 - 如果用户在NAT后（如公司网络），IP定位可能不准，建议提供手动输入城市名的fallback路径
打包后时钟停摆或API调用超时
打包成jar后常见问题：HTTP连接卡住、SSL证书异常、或定时任务没启动。本质是环境差异放大了开发时忽略的细节。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- HTTP客户端必须设超时：
HttpURLConnection.setConnectTimeout(3000)和setReadTimeout(5000) - 如果用OkHttp，确认jar包里包含
okhttp和okio，Maven要加<scope>runtime</scope> - SSL问题多因JDK版本低（如JDK8u161以下），升级JDK或在启动参数加
-Djavax.net.ssl.trustStore=... - 主函数末尾别忘了
Thread.currentThread().join()，否则main线程结束，后台刷新线程直接被杀
最难调的其实是网络策略——公司防火墙可能放行浏览器但拦截Java进程的HTTPS请求，这时候得抓包看实际发出去的Host和User-Agent是否被拦。别急着改代码，先确认请求真发出去了没。
