使用HttpURLConnection调用天气API需设置User-Agent、启用重定向、URL编码中文、逐层解析JSON；注意和风需城市ID与lang=zh，OpenWeatherMap需units=metric及q/lat参数，避免403、429和解析异常。
用 HttpURLConnection 发起 GET 请求获取天气数据
Java 标准库自带的 HttpURLConnection 足够完成基础天气 API 调用，无需额外依赖。关键在于正确设置请求头、处理重定向和读取响应流。
- 必须设置
conn.setRequestProperty("User-Agent", "Mozilla/5.0")，否则部分天气 API（如和风、心知）会返回 403 - 务必调用
conn.setInstanceFollowRedirects(true)，避免因 301/302 跳转导致读到空响应 - 响应体要用
BufferedReader按行读取，不能直接conn.getInputStream().readAllBytes()（JDK 8 不支持） - 中文城市名需先用
URLEncoder.encode("北京", "UTF-8")编码，否则 URL 解析失败
解析 JSON 响应时避开 org.json 的常见陷阱
天气 API 返回的是标准 JSON，但新手常在解析时遇到 JSONException: JSONObject["xxx"] not found 或空指针。问题往往出在字段路径或类型误判上。
- 先用在线工具（如 jsonlint.com）校验返回体结构，确认实际字段名是
now还是data.now -
JSONObject.get("temperature")会抛异常，改用optInt("temperature", -999)或optString("temperature", "N/A") - 嵌套对象要逐层检查：先
json.optJSONObject("now")，再从中取optString("text_day")，不能链式调用json.getJSONObject("now").getString("text_day") - 数组字段（如预报列表）要用
optJSONArray("daily_forecast")，空数组时getJSONArray直接炸
使用免费天气 API 时必须注意的配额与参数细节
和风天气（https://dev.qweather.com）和 OpenWeatherMap 是最常用的免费源，但它们的请求格式、认证方式和字段命名差异很大。
- 和风要求
location参数传城市 ID（如101010100），不是城市名；需先调用「城市搜索」接口查 ID，或用其提供的城市 ID CSV 文件 - OpenWeatherMap 用
q=beijing或lat=39.9&lon=116.4，但免费 Key 每分钟最多 1000 次，超限返回429 Too Many Requests - 两个 API 都要求在 URL 中携带
key=YOUR_KEY，和风还强制加lang=zh才返回中文描述 - 响应里温度单位默认是开尔文（K），OpenWeatherMap 需加
&units=metric才得摄氏度
URL url = new URL("https://devapi.qweather.com/v7/weather/now?location=101010100&key=YOUR_KEY&lang=zh");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("User-Agent", "Mozilla/5.0");
conn.setConnectTimeout(5000);
conn.setReadTimeout(5000);
int responseCode = conn.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"));
StringBuilder resp = new StringBuilder();
String line;
while ((line = reader.readLine()) != null) resp.append(line);
reader.close();
JSONObject json = new JSONObject(resp.toString());
JSONObject now = json.optJSONObject("now");
if (now != null) {
String temp = now.optString("temp", "未知");
String text = now.optString("text_day", "无描述");
System.out.println("当前温度：" + temp + "℃，天气：" + text);
}
}
真正卡住人的往往不是写不出请求，而是没意识到城市 ID 和温度单位这些“默认不透明”的约定。调试时先手动把完整 URL 粘到浏览器里看返回结果，比盯着 Java 报错更有用。 
