Java实现天气查询HTTP请求教程

本文详解如何用Java原生HttpURLConnection安全、稳定地调用主流免费天气API（如和风天气与OpenWeatherMap），涵盖从发起HTTP请求、规避403/429错误、正确编码中文城市名、处理重定向，到逐层健壮解析JSON响应的完整实战要点——没有花哨依赖，只有直击痛点的硬核技巧：为什么必须设User-Agent？为何城市ID比城市名更重要？怎样避免空指针和字段不存在异常？调试时浏览器先行为何比死磕报错更高效？读完即可避开90%新手踩过的坑，让天气查询真正跑起来。

用 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 报错更有用。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Java实现天气查询HTTP请求教程》文章吧，也可关注golang学习网公众号了解相关技术文章。