百度翻译API需实名认证后在fanyi-api.baidu.com创建“通用”类型应用获取APP_ID和SECRET_KEY；签名须用MD5(APP_ID+q+salt+SECRET_KEY)生成，q要URL编码，salt每次随机；请求用POST、设UTF-8头，语言代码如"jp"；注意52001超时、54000缺参、空q导致trans_result为空；限流2QPS，密钥勿硬编码。
百度翻译API怎么申请和配密钥
百度翻译开放平台需要实名认证后才能创建应用、获取 APP_ID 和 SECRET_KEY。没这俩值，所有请求都会返回 {"error_code":"52003","reason":"UNAUTHORIZED_USER"}。
- 进入 fanyi-api.baidu.com，用百度账号登录并完成实名
- 创建应用时，“应用名称”随便填，但“应用类型”必须选「通用」，否则调用会报
error_code: 54004（权限不足）
- 生成的
SECRET_KEY 只显示一次，务必立刻复制保存；它不能重置，只能删应用重建
Java里怎么发签名请求调用翻译接口
百度翻译要求每个请求带签名（sign），不是简单拼个 token 就行。签名逻辑是：MD5(APP_ID + q + salt + SECRET_KEY)，其中 q 是待翻译文本（需 UTF-8 编码后 URL encode），salt 是随机数（推荐用 System.currentTimeMillis()）。
- 必须用
HttpURLConnection 或 OkHttpClient 发 POST 请求，不能用 GET（会超长或编码错）
- 请求头必须设
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
- 参数里
from 和 to 要写标准语言代码，比如 "zh"、"en"、"jp"（注意日语是 jp 不是 ja）
- 响应体是 JSON，别直接
toString()，要用 new String(bytes, "UTF-8") 解码，否则中文变乱码
怎么处理常见错误码和空响应
实际跑起来最常卡在三类问题：
-
error_code: 52001 —— 网络超时，不是密钥错。建议加连接/读取超时（如 5 秒），并重试 1 次
-
error_code: 54000 —— 请求参数缺失，检查是否漏了 q、from、to、app_id、sign、salt 这六个必填项
- 返回 JSON 有
"trans_result" 但为空数组 —— 多半是 q 字符串为空或全是空白符，调用前加 q = q.trim() 并判空
要不要自己封装成工具类？注意什么
可以封装，但别过度设计。一个轻量 BaiduTranslator 类就够，暴露单个方法如 translate(String text, String from, String to)。
- 别把
APP_ID 和 SECRET_KEY 写死在代码里，从系统属性或配置文件读（如 System.getProperty("baidu.appid")）
-
salt 每次请求必须新生成，不能复用，否则签名失效
- 百度限流是 2 QPS（每秒 2 次），并发高时得加简单计数器或延迟，不然连续失败返回
52008（频率超限）
error_code: 54004（权限不足） SECRET_KEY 只显示一次，务必立刻复制保存；它不能重置，只能删应用重建 sign），不是简单拼个 token 就行。签名逻辑是：MD5(APP_ID + q + salt + SECRET_KEY)，其中 q 是待翻译文本（需 UTF-8 编码后 URL encode），salt 是随机数（推荐用 System.currentTimeMillis()）。
- 必须用
HttpURLConnection或OkHttpClient发 POST 请求，不能用 GET（会超长或编码错） - 请求头必须设
Content-Type: application/x-www-form-urlencoded; charset=UTF-8 - 参数里
from和to要写标准语言代码，比如"zh"、"en"、"jp"（注意日语是jp不是ja） - 响应体是 JSON，别直接
toString()，要用new String(bytes, "UTF-8")解码，否则中文变乱码
怎么处理常见错误码和空响应
实际跑起来最常卡在三类问题：
-
error_code: 52001 —— 网络超时，不是密钥错。建议加连接/读取超时（如 5 秒），并重试 1 次
-
error_code: 54000 —— 请求参数缺失，检查是否漏了 q、from、to、app_id、sign、salt 这六个必填项
- 返回 JSON 有
"trans_result" 但为空数组 —— 多半是 q 字符串为空或全是空白符，调用前加 q = q.trim() 并判空
要不要自己封装成工具类？注意什么
可以封装，但别过度设计。一个轻量 BaiduTranslator 类就够，暴露单个方法如 translate(String text, String from, String to)。
- 别把
APP_ID 和 SECRET_KEY 写死在代码里，从系统属性或配置文件读（如 System.getProperty("baidu.appid")）
-
salt 每次请求必须新生成，不能复用，否则签名失效
- 百度限流是 2 QPS（每秒 2 次），并发高时得加简单计数器或延迟，不然连续失败返回
52008（频率超限）
error_code: 52001 —— 网络超时，不是密钥错。建议加连接/读取超时（如 5 秒），并重试 1 次 error_code: 54000 —— 请求参数缺失，检查是否漏了 q、from、to、app_id、sign、salt 这六个必填项 "trans_result" 但为空数组 —— 多半是 q 字符串为空或全是空白符，调用前加 q = q.trim() 并判空 BaiduTranslator 类就够，暴露单个方法如 translate(String text, String from, String to)。
- 别把
APP_ID和SECRET_KEY写死在代码里，从系统属性或配置文件读（如System.getProperty("baidu.appid")） -
salt每次请求必须新生成，不能复用，否则签名失效 - 百度限流是 2 QPS（每秒 2 次），并发高时得加简单计数器或延迟，不然连续失败返回
52008（频率超限）
签名算错、语言代码写错、密钥没复制全——这三个点占了调试时间的八成。其他都是小问题。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
