java url编解码需仅对参数值用urlencoder/urldecoder指定utf-8，避免编码整个url或忽略字符集；推荐封装urlcodec工具类统一处理，并在复杂场景使用uri构造器或okhttp等库。
Java 中字符串的 URL 编码和解码，核心是确保参数值能安全传输、不被 URL 解析器误切，同时避免乱码或二次编码。直接用 URLEncoder 和 URLDecoder 是基础，但“安全处理”关键在于封装规范、规避常见陷阱——推荐通过自定义工具类统一管控。
只对参数值编码，且必须指定 UTF-8
URLEncoder 不是为整个 URL 设计的，它专用于 application/x-www-form-urlencoded 格式的参数值（即 ? 后面的 value 部分）。编码时务必传入字符集：
- ✅ 正确：
URLEncoder.encode("张三+李四", "UTF-8")→%E5%BC%A0%E4%B8%89%2B%E6%9D%8E%E5%9B%9B - ❌ 错误：
URLEncoder.encode(url)（无参）→ 依赖平台默认编码，Windows 可能是 GBK，Linux 是 UTF-8，极易乱码 - ❌ 危险：
URLEncoder.encode("https://a.com?q=xxx")→ 把:、/全部编码，URL 失效
解码需与编码严格匹配，且自动兼容 + 和 %20
URLDecoder 能正确识别空格的两种表示（+ 和 %20），但同样必须指定 "UTF-8"：
- ✅ 安全解码：
URLDecoder.decode("%E5%BC%A0%E4%B8%89+test", "UTF-8")→"张三 test" - ❌ 隐患操作：未捕获
UnsupportedEncodingException或IllegalArgumentException（如遇到非法编码如%XY） - ⚠️ 注意：Servlet 容器（如 Tomcat）通常已对
request.getParameter()自动解码，手动再解一次会出错
封装成工具类，屏蔽底层细节
建议定义一个轻量 UrlCodec 工具类，集中处理异常、固定编码、并提供语义化方法：
- 提供
encodeParam(String value)：内部调用URLEncoder.encode(value, "UTF-8")，并把+替换为%20（满足部分 API 对空格格式的强制要求） - 提供
decodeParam(String encoded)：包装URLDecoder.decode(...)，捕获异常并返回空字符串或抛运行时异常 - 不暴露原始
URLEncoder，避免误用；也不支持编码参数名（除非明确需要，如user name→user%20name）
复杂场景优先用 URI 构造器或 HTTP 客户端库
当涉及路径含中文、带 fragment、或需构建完整可执行 URL 时，URLEncoder 就不够用了：
- ✅ 推荐：
new URI(scheme, userInfo, host, port, path, query, fragment)—— 它会自动对 path 和 query 分段编码，更符合 RFC 3986 - ✅ 生产级选择：用 OkHttp 或 Apache HttpClient 构建请求，它们内部已封装 URI 安全构造逻辑，无需手动拼接+编码
- ❌ 避免：自己用
String.format拼 URL + 手动 encode，易漏、易重复、难维护
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
