Postman 中含斜杠的参数需 URL 编码为%2F，Query 参数在 Params 标签页自动编码，Path 参数须手动编码；Spring Boot 的 @PathVariable 需配合正则 .+（如 /files/{path:.+}）并同样编码斜杠。
Postman 里 URL 中的斜杠会被截断，怎么传完整值？
Postman 默认把 / 当作路径分隔符，直接填在 Params 或 URL 里会导致参数被错误解析——比如你填 path=/api/v1/users，实际发出去可能只剩 path=api 或触发 404。根本原因不是 Postman “bug”，而是 HTTP 规范要求路径中未编码的 / 必须参与路由匹配。
- 必须对含
/的参数值做 URL 编码：用%2F替换每个/ - 不要手动拼接在 URL 字符串里（如
?path=/api/v1），改用 Params 标签页自动编码 - 如果参数值是完整路径（如
/admin/dashboard），编码后应为%2Fadmin%2Fdashboard - Postman 的 Params 表格会自动对值调用
encodeURIComponent()，但仅限 Query 参数；Path 参数仍需手动编码
Path 参数里带斜杠，@PathVariable 绑定失败怎么办？
Spring Boot 的 @PathVariable 默认不支持路径段内含 /，因为 URI 解析器会在第一个 / 处截断。比如 /files/{path} + path=logs/2026/11/error.log，后端实际收到的只是 logs。
- 后端需改用正则匹配：写成
@GetMapping("/files/{path:.+}")，其中.+允许匹配任意字符（包括/） - Postman 中仍要对值编码：填
logs%2F2026%2F11%2Ferror.log，不能填原始斜杠 - 若用的是旧版 Spring（matrix variables，否则正则写法无效
- 测试时打开 Postman 控制台（View → Show Postman Console），看发出的原始 URL 是否已正确编码
Body 里传 JSON，字段值含斜杠，需要额外处理吗？
不需要。JSON 字符串中的 / 是合法字符，只要外层 Content-Type 是 application/json，且 JSON 格式正确，Postman 不会对 Body 内容做 URL 解码或路径解析。
Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma
- 在 Body → raw → JSON 模式下，直接写：
{"path":"/api/v1/resource"} - 注意不要误选
x-www-form-urlencoded，它会对所有值做 URL 编码，导致后端收到双编码字符串 - 如果后端解析出错，先检查是否把 JSON 当成表单数据在用
request.getParameter()读取——那是错的，得用流读取 body 并解析 JSON
批量编辑时斜杠被吃掉，Bulk Edit 怎么写才安全？
Bulk Edit 模式下，Postman 把整行当键值对解析，遇到未转义的 / 可能被误判为注释或分隔符，尤其在粘贴日志路径、Git 分支名等含多级斜杠的值时。
- 批量编辑必须用 URL 编码格式：写成
branch%3Dmain%2Ffeature%2Fauth，而不是branch=main/feature/auth - 双斜杠
//在 Bulk Edit 中是注释符，哪怕写在值里也会触发注释（如url=https://a.com//b会被截断） - 最稳妥方式：先在 Params 标签页逐个添加并确认编码结果，再切到 Bulk Edit 复制已编码后的值
- 如果值里有多个
/，用浏览器控制台临时跑encodeURIComponent("main/feature/auth")快速生成
真正容易被忽略的是：**URL 编码必须由发送方（Postman）完成，且编码时机取决于参数类型**。Query 和 Body 交给 Postman 自动处理即可；Path 参数必须人工编码，且后端路由必须配合正则放开限制——两边缺一不可。
