Postman调用本地接口的核心是确保服务运行且请求可达:URL用http://127.0.0.1:端口/路径,参数走Params,POST JSON需Header设Content-Type并Body选raw+JSON,避免400/415/401错误。

Postman 调用本地接口,核心就一条:确保你的服务正在运行,且 Postman 发出的请求能被它监听到。只要端口没被占用、防火墙没拦、URL 拼对了,90% 的“调不通”问题当场解决。
本地服务启动后,Postman 怎么填 URL
本地服务地址格式固定为 http://127.0.0.1:端口号/路径 或 http://localhost:端口号/路径,二者等价,但推荐用 127.0.0.1(避免某些系统 hosts 重定向干扰)。
- Spring Boot 默认端口是
8080,启动后访问http://127.0.0.1:8080/actuator/health能返回{"status":"UP"}就说明服务起来了 - XXL-JOB 执行器内嵌服务端口默认是
9999,不是项目server.port,调用任务要用http://127.0.0.1:9999/run - MCP 的 SSE 接口如
/sse,必须用 Postman 11.53.2+ 版本,旧版不支持流式响应解析 - 如果 URL 中带查询参数,别手动拼在地址栏里;切到
ParamsTab 填表格,工具会自动编码并同步到 URL,避免空格、中文、特殊符号出错
GET 和 POST 请求 Body 和 Header 怎么配才不报错
400、415、401 这三类错误,八成出在 Body 类型或 Header 配置上。
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
-
GET请求不能有Body—— Postman 允许你填,但绝大多数服务端直接忽略或报错,参数一律走Params -
POST发 JSON,必须同时满足两个条件:Headers里有Content-Type: application/json,且Body选raw+JSON格式;只设 Header 不选对格式,或只选格式不设 Header,都可能触发415 Unsupported Media Type - 需要鉴权时,别手敲
Authorization: Bearer xxx;切到AuthorizationTab,类型选Bearer Token,填入 token 即可,工具会自动补全 Header,避免大小写、空格、冒号后多空格等低级错误 - 传文件或表单,选
form-data;传传统键值对(如登录表单),选x-www-form-urlencoded;这两者都会自动设置对应Content-Type,不用手动填
为什么明明服务跑着,Postman 却连不上
常见原因不是 Postman 有问题,而是网络或配置层面被卡住了。
- Java 服务(如 Spring Boot)默认只监听
localhost,如果你用127.0.0.1调不通,试试localhost,反之亦然——某些 JDK 版本对这两个地址的解析行为不一致 - 服务启用了 HTTPS 但本地没配证书?在 Postman 设置里关掉
SSL certificate verification(Settings → General → SSL certificate verification) - 服务绑定了
0.0.0.0但防火墙拦截了该端口?临时关闭防火墙测试,或检查 Windows Defender / macOS 防火墙是否放行了对应端口 - Postman 代理开着(比如开了 Charles 或 Fiddler)?右下角看状态栏有没有代理图标,有的话点开关掉,本地调试不需要中间代理
环境变量怎么设才能少改 URL
硬编码 http://127.0.0.1:8080 在每个请求里,等于给自己埋雷。
- 新建环境(
Environments→+ Add),起名如local,添加变量host=127.0.0.1,port=8080 - URL 改成
http://{{host}}:{{port}}/api/users,切换环境时只需换一套变量值,不用动任何请求 - 全局变量适合存
token或user_id这类所有接口共用的值,但注意:全局变量无法按环境隔离,敏感信息慎用 - 变量引用必须用双花括号
{{xxx}},漏一个括号、多一个空格,Postman 就当普通字符串处理,不会替换
真正容易被忽略的是服务本身的监听范围和 Postman 的协议一致性:Java 应用默认不监听 IPv6 地址,而某些系统会把 localhost 解析成 ::1;Postman 发请求时若 DNS 解析走 IPv6,但服务没开 IPv6 监听,就会静默失败。最稳的做法,始终用 127.0.0.1,并确认服务日志里打印的是 Started ServerConnector@xxx{HTTP/1.1, (http/1.1)}{127.0.0.1:8080} 这类明确绑定 IPv4 的提示。

















