Java初学者可用不到200行代码实现文本翻译工具，核心是掌握HttpURLConnection发起POST请求、正确设置请求头、区分成功与错误响应流、用org.json安全解析JSON及UTF-8解码，避免硬编码解析和默认编码乱码。
Java初学者用不到 200 行代码就能做出一个能跑通的文本翻译工具，关键不是调 API，而是搞懂怎么组织请求、处理响应、应对常见失败——否则你连 403 Forbidden 和 429 Too Many Requests 都分不清，更别说调试。
用 HttpURLConnection 发起翻译请求，别急着上 OkHttp
初学者直接引入第三方 HTTP 库，容易把网络层、JSON 解析、业务逻辑全搅在一起。先用 JDK 自带的 HttpURLConnection 把流程走通，问题定位更直接。
- 必须显式设置
setDoOutput(true)才能发 POST 请求 - 请求头要加
Content-Type: application/json; charset=utf-8，否则很多翻译 API（如腾讯、百度）直接返回400 Bad Request - 记得调用
connect()后再获取getInputStream()或getErrorStream()，否则可能卡住或抛IOException - 响应码不是 200 时，
getInputStream()会抛异常，得用getErrorStream()读错误体
解析 JSON 响应：用 org.json 而不是手撕字符串
别用 String.indexOf() 或 split() 去“提取”翻译结果——API 响应结构稍一变就全崩。引入轻量级 org.json（Maven 坐标：org.json:json:20231013）就够了。
Baidu Nearby / 百度能力集合
下载
百度能力集合，提供百度搜索和百度地图路线规划功能，包含网页搜索、路线规划和附近场所推荐，适用于搜索网页、规划出行路线及查找附近餐饮、景点、酒店等位置服务。
- 检查字段是否存在再取值，比如
json.has("trans_result")，避免JSONException: JSONObject["trans_result"] not found - 数组字段要用
getJSONArray()，对象字段用getJSONObject()，类型错一次就ClassCastException - 中文返回乱码？确保用
new String(bytes, StandardCharsets.UTF_8)解码，别依赖平台默认编码
String response = new String(Objects.requireNonNull(conn.getInputStream()).readAllBytes(), StandardCharsets.UTF_8);
JSONObject json = new JSONObject(response);
if (json.has("error_code")) {
System.err.println("API error: " + json.getString("error_msg"));
} else if (json.has("trans_result")) {
JSONArray results = json.getJSONArray("trans_result");
for (int i = 0; i < results.length(); i++) {
System.out.println(results.getJSONObject(i).getString("dst"));
}
}
处理常见错误：从 401 Unauthorized 到超时重试
翻译 API 不像本地方法，它随时可能拒绝你。硬编码密钥、不设超时、不判状态码，第一次部署到别人机器上就挂。
立即学习“Java免费学习笔记（深入）”；
-
401 Unauthorized：密钥无效或未传app_id/access_token；检查是否漏了签名计算（如百度翻译需sign = md5(appid+q+salt+secretKey)） -
429 Too Many Requests：没加请求间隔，连续调用触发限流；初学阶段加Thread.sleep(1000)最简单有效 - 连接超时：设置
setConnectTimeout(5000)和setReadTimeout(5000)，否则卡死在connect()上 - 空响应或
null：服务端返回空体或网络中断，readAllBytes()可能返回空数组，需判空
真正难的不是写完“能翻”，而是让程序在密钥错、网络抖、API 改版时还能给你一句明白话——比如打印出完整错误响应体，而不是只抛个 IOException。这点老手也常漏。
