初学者用HttpURLConnection调用OpenWeatherMap API实现天气应用，需注意URL拼接、URLEncoder编码、User-Agent设置、异常处理及org.json安全解析，并用SwingWorker避免GUI阻塞。
Java初学者做天气应用，别一上来就搞 Spring Boot 或 HTTP 客户端封装——HttpURLConnection 足够跑通流程，且能看清请求-响应全链路。真正卡住新手的，从来不是“怎么写”，而是“为什么返回 403”“JSON 解析报 JSONException 却没提示哪一行”“城市名带空格就查不到”。下面直奔实操。
用 HttpURLConnection 发起 GET 请求获取天气 JSON
OpenWeatherMap 免费 API 是最稳妥的起点（注册后得 appid）。注意：它要求请求 URL 中必须带 appid 参数，且不能用 POST；很多初学者误用 setRequestMethod("POST") 导致 405 错误。
- URL 必须是完整字符串，例如：
https://api.openweathermap.org/data/2.5/weather?q=Beijing&appid=your_key_here&units=metric - 手动拼接参数时，城市名要用
URLEncoder.encode(city, "UTF-8")，否则中文或空格直接 400 - 必须显式设置
conn.setRequestProperty("User-Agent", "JavaApp")，否则部分 API 返回 403（被当成爬虫拦截） - 记得调用
conn.connect()，再用conn.getInputStream()读响应，别漏掉异常分支里的getErrorStream()
用 org.json 解析响应，避开 NullPointerException
别自己用 String.split() 或正则去截 JSON 字段——org.json 轻量且 JDK 无依赖。但新手常在没校验字段存在性的情况下直接调用 getDouble("temp")，结果遇到 JSONException: No value for temp。
- 先用
new JSONObject(jsonString)构造顶层对象，再逐层检查键是否存在：if (root.has("main") && root.getJSONObject("main").has("temp")) - 温度字段在
"main"对象里，单位是开尔文（K），要转摄氏度得减 273.15；别直接用getInt()读小数，用getDouble() - 城市名在
"name"，国家码在"sys.country"，注意sys是嵌套对象，不是字符串路径
用 Swing 做极简 UI，避免线程阻塞界面
JFrame + JTextField + JButton 就够展示核心逻辑。但重点：网络请求不能在 EDT（事件分发线程）里执行，否则点击按钮后整个窗口假死。
立即学习“Java免费学习笔记（深入）”；
- 把 HTTP 请求逻辑包进
SwingWorker，重写doInBackground()发请求、done()更新 UI - 按钮点击后立即设为
setEnabled(false)，防止重复提交；done()里再设回true - 错误提示别用
System.out.println()，改用JOptionPane.showMessageDialog(...)，否则控制台看不到报错
public class WeatherApp extends JFrame {
private JTextField cityField = new JTextField(15);
private JLabel resultLabel = new JLabel("输入城市名，点击查询");
public WeatherApp() {
JButton queryBtn = new JButton("查询");
queryBtn.addActionListener(e -> {
String city = cityField.getText().trim();
if (!city.isEmpty()) {
queryBtn.setEnabled(false);
new WeatherTask().execute(city);
}
});
add(new JLabel("城市："), BorderLayout.WEST);
add(cityField, BorderLayout.CENTER);
add(queryBtn, BorderLayout.EAST);
add(resultLabel, BorderLayout.SOUTH);
setDefaultCloseOperation(EXIT_ON_CLOSE);
pack(); setVisible(true);
}
private class WeatherTask extends SwingWorkerzuojiankuohaophpcnJSONObject, Voidyoujiankuohaophpcn {
@Override
protected JSONObject doInBackground(String... cities) throws Exception {
return fetchWeather(cities[0]); // 实现见上一节
}
@Override
protected void done() {
try {
JSONObject data = get();
double temp = data.getJSONObject("main").getDouble("temp") - 273.15;
String name = data.getString("name");
resultLabel.setText(String.format("%s: %.1f°C", name, temp));
} catch (Exception ex) {
resultLabel.setText("查询失败：" + ex.getMessage());
JOptionPane.showMessageDialog(null, ex.toString());
} finally {
((JButton)getRootPane().getContentPane().getComponent(2)).setEnabled(true);
}
}
}}
真实项目里，API 密钥不该硬编码在 Java 文件中；城市搜索建议加下拉补全；但对初学者，先确保一次请求能打出正确温度——比堆砌功能重要得多。最容易忽略的是：每次改完代码，记得删掉旧的 .class 文件再编译，否则可能跑着上一版逻辑还一脸懵。
