必须使用 encodeuricomponent() 编码 url 路径参数，因其能编码 /、?、#、空格、中文等所有非保留字符，确保参数作为原子路径段不被误解析；encodeuri() 会保留 / 等字符，导致路由错误；直接拼接更危险。
对 URL 路径参数（即路径中动态部分，如 /user/张三 中的 张三）进行安全编码，关键在于：**必须使用 encodeURIComponent()，绝不能用 encodeURI() 或直接拼接**。
为什么路径参数必须用 encodeURIComponent()
URL 路径中的参数可能含中文、空格、斜杠（/）、问号（?）、井号（#）等。这些字符在路径里有双重身份：
- 像
/在路径中是分隔符（如/api/v1/user/John Doe），但如果用户昵称恰好是"admin/users"，不编码就会被误解析为子路径； - 空格、中文、
+、&等若未编码，会导致路径截断、404 或服务器路由匹配失败； -
encodeURI()会放过/、?、#等保留字符，无法保护路径段的完整性； -
encodeURIComponent()编码所有非 URI 保留字符（包括/、?、#、空格、中文等），确保整个参数值被当作一个“原子”路径片段处理。
正确编码路径参数的操作方式
假设你要构造请求地址：GET /api/city/Beijing → GET /api/city/New York → GET /api/city/上海市浦东新区：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 错误写法（直接拼接）：
`/api/city/${cityName}`→/api/city/New York（空格破坏路径）； - 错误写法（用 encodeURI）：
encodeURI(`/api/city/${cityName}`)→/api/city/New%20York✅，但若cityName = "shanghai/chaoyang"，结果仍是/api/city/shanghai/chaoyang❌（斜杠未被编码，变成两个路径段）； - 正确写法（仅编码参数值）：
`/api/city/${encodeURIComponent(cityName)}`→/api/city/New%20York✅，/api/city/%E4%B8%8A%E6%B5%B7%E5%B8%82%E6%B5%A6%E4%B8%9C%E6%96%B0%E5%8C%BA✅，/api/city/shanghai%2Fchaoyang✅（/变成%2F，保留在同一路径段内）。
常见易错场景提醒
以下情况尤其需要警惕：
- 用户输入的姓名、地址、文件名作为路径一部分时（如
/download/我的报告.pdf）； - RESTful 路由中带层级语义的 ID（如 GitHub 的
/repos/{owner}/{repo}，owner 可能含.或-，虽安全，但若含/就必须编码）； - 拼接后用于
fetch()、axios.get()或window.location.href跳转——只要涉及动态路径段，一律单独编码参数值； - 不要对整个 URL 调用
encodeURIComponent()，那会把https://、/、?全部乱码，导致请求彻底失效。
配套解码建议（服务端或调试时）
前端编码后，服务端需做对应解码（如 Node.js Express 中 req.params.city 通常已由框架自动解码；PHP 中 $_SERVER['PATH_INFO'] 需用 urldecode()；Nginx 代理下注意是否开启 merge_slashes off 避免提前截断）。调试时可用 decodeURIComponent() 还原查看原始值：
console.log(decodeURIComponent('New%20York')); // → "New York"Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
