URLEncoder 不能编码整个 URL，因为它会错误转义协议、路径等必需字符（如/、:、?），导致 URL 失效；应仅对查询参数值单独编码，或使用 java.net.URI 自动精准编码各组件。
URLEncoder 不是为编码完整 URL 设计的，它只适合编码 URL 中的查询参数值（application/x-www-form-urlencoded 格式），直接用它编码整个 URL 会导致斜杠 /、冒号 :、问号 ? 等被错误转义，最终 URL 失效。
为什么不能用 URLEncoder.encode() 编码整个 URL
因为 URLEncoder 的设计目标是编码表单提交中的键值对（如 name=张三&city=北京），它会把所有非字母数字字符（包括 /、:、?、=）都按规则转义成 %XX 形式。而完整 URL 的结构（协议、域名、路径、查询参数）依赖这些字符的原始语义。
常见错误现象：
- 原 URL：
https://api.example.com/v1/users?id=123&name=张三 - 错误编码后：
https%3A%2F%2Fapi.example.com%2Fv1%2Fusers%3Fid%3D123%26name%3D%E5%BC%A0%E4%B8%89—— 已无法被 HTTP 客户端识别为有效 URL
正确做法：只编码查询参数的 value 部分
应手动拆分 URL，仅对查询参数中每个 value 单独调用 URLEncoder.encode()，并指定 UTF-8 编码；其余部分（协议、主机、路径、分隔符）保持不变。
立即学习“Java免费学习笔记（深入）”；
示例逻辑：
String baseUrl = "https://api.example.com/v1/search";
String query = "q=" + URLEncoder.encode("java 编程", "UTF-8") +
"&page=" + URLEncoder.encode("2", "UTF-8");
String fullUrl = baseUrl + "?" + query;
// 结果：https://api.example.com/v1/search?q=java+%E7%BC%96%E7%A8%8B&page=2
关键点：
- 必须显式传入
"UTF-8"，否则依赖平台默认编码（可能出错） -
URLEncoder会把空格转为+（符合x-www-form-urlencoded规范），不是%20；若需统一用%20，可后续替换.replace("+", "%20") - 路径中的中文（如
/用户/列表）不属于查询参数，不应走URLEncoder；应改用URI构造器或java.net.URI类来安全处理
更安全的替代方案：用 java.net.URI 构建
当 URL 含有路径段或查询参数且含特殊字符时，URI 构造器能自动区分各组件并做精准编码，避免手撕字符串出错。
示例：
URI uri = new URI("https", "api.example.com", "/v1/users", "name=张三&role=开发", null);
String safeUrl = uri.toString();
// 自动编码后：https://api.example.com/v1/users?name=%E5%BC%A0%E4%B8%89&role=%E5%BC%80%E5%8F%91
注意：
-
URI构造器第 4 个参数是 raw query string（不预先编码），它内部会对 query 值做标准编码，但保留=、&等分隔符不编码 - 路径段（path）若含中文，应作为
URI的path参数传入（而非拼在字符串里），由URI自动处理 - 不要用
new URL(...)替代 ——URL类不负责编码，构造时遇到非法字符直接抛MalformedURLException
真正容易被忽略的是：URL 各组成部分的编码规则并不统一 —— 路径段用 %XX，查询值用 x-www-form-urlencoded（空格→+），而 URLEncoder 只覆盖后者。混用或全量编码，几乎必然出错。
