Postman调用本地接口必须显式写出端口号，如http://localhost:3000/api/login；省略端口则默认使用80（HTTP）或443（HTTPS），导致连接失败。
Postman 调用指定端口的接口，关键不是“能不能”，而是 URL 格式写对没写对——localhost 或 127.0.0.1 后面必须显式带上 :端口号，否则默认走 :80（HTTP）或 :443（HTTPS），99% 的本地开发服务根本不在那俩端口上。
URL 中端口部分必须显式写出，不能省略
很多人填 http://localhost/api/login 结果连不上，就是因为本地服务实际跑在 :3000 或 :8080。Postman 不会自动探测端口，它严格按 RFC 解析 URL：
-
http://localhost:3000/api/login✅ 明确指定了端口 -
http://localhost/api/login❌ 默认解析为:80，除非你真在 80 端口起了服务 -
https://api.example.com/users✅ HTTPS 默认是:443，一般不用写 -
http://192.168.1.100:5000/health✅ 局域网设备也一样，端口不可省
常见错误：端口写在 path 前面、或和 query 混在一起
错误写法会导致 404 或连接被拒绝，比如：
-
http://localhost/api:3000/login→ 端口位置错，:3000被当成了 path 一部分 -
http://localhost:3000?port=8080/api/test→?port=8080是 query 参数，不是端口声明 -
http://localhost:3000:/api/test→ 多了个冒号，URL 解析失败
正确结构永远是：协议://主机名:端口号/路径?查询参数
Postman 12.27.7
下载
Postman 12.27.7 Windows x64 官方安装包，适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力，以及接口规范标签管理改进，适合受限网络测试与规范资源组织场景。
本地服务端口不确定？先确认再填
别靠猜，直接查进程或日志：
- Node.js 项目启动时通常打印类似
Server running on http://localhost:3000 - Spring Boot 默认是
:8080，但可能被application.properties改成server.port=9090 - Python Flask/FastAPI 启动日志里有
* Running on http://127.0.0.1:8000 - Windows 下用
netstat -ano | findstr :端口号确认端口是否真被占用
如果服务监听的是 0.0.0.0:8080，Postman 用 http://localhost:8080 或 http://127.0.0.1:8080 都可以；但监听 192.168.1.100:8080 就只能用那个 IP，localhost 会失败。
环境变量能避免端口硬编码，但别漏掉冒号
用环境变量管理不同环境时，容易在变量值里漏掉 :：
- ✅ 正确定义环境变量
BASE_URL = http://localhost:3000 - ❌ 错误定义
BASE_URL = http://localhost+ 单独设PORT = 3000，然后拼成{{BASE_URL}}{{PORT}}/api→ 结果是http://localhost3000/api（缺冒号） - ✅ 推荐写法：统一用
BASE_URL = http://localhost:3000，所有请求都基于它，如{{BASE_URL}}/api/login
端口是 URL 的结构性组成部分，不是可选修饰项——少一个冒号，整个请求就发向了错误的目标。
