导入Swagger后参数为空或错乱，主因是OpenAPI 2.0/3.x格式不规范或兼容问题；应检查文档版本、requestBody/parameters结构、schema type缺失，并优先转为3.x格式；手动补参数、Examples及Pre-request Script动态生成可保障测试可用性。
导入 Swagger 时参数没生成或全是空值怎么办
Postman 导入 Swagger（OpenAPI）后，Params 或 Body 里参数为空、缺字段、类型错乱，根本不是文档里定义的样子——这通常不是 Postman bug，而是 OpenAPI 文档本身结构不规范或版本兼容问题。
关键判断点：swagger: "2.0" 和 openapi: "3.0.0"（或更高）在参数解析逻辑上差异极大。Postman v10+ 对 OpenAPI 3.x 支持较好，但对部分 2.0 文档中 parameters 嵌套过深、schema 缺失 type、或用 body + schema 而非 requestBody 的写法，会直接跳过参数提取。
- 检查导出的 JSON/YAML 文件开头：如果是
swagger: "2.0"，优先尝试升级为 3.x 格式（可用 OpenAPI Converter 在线转换） - 确认每个
path下的post/get操作中，requestBody（3.x）或parameters（2.0）节点是否完整，尤其schema必须含type（如"type": "object"），否则 Postman 不识别为可生成参数 - 避免在
parameters中混用in: "body"（2.0 已废弃），应统一用in: "query"/"header"/"path"，body 内容必须走requestBody
导入后如何手动补全参数示例（非自动生成）
当自动解析失败，又不能改源文档时，得靠人工补参数 + 示例值。重点不是“填满”，而是让后续测试能跑通——尤其是带校验逻辑的字段（如手机号格式、密码长度）。
操作路径：打开导入后的请求 → 切到 Params 或 Body > raw → 点右上角 Examples → Add example。
-
Params补 query 参数：在Params表格里手动输入key（如page）、value（如1），勾选Encode（Postman 默认启用，确保空格、中文等被正确编码） -
Body补 JSON 示例：切到raw，选择JSON类型，粘贴合法 JSON（注意末尾不能多逗号），并在Headers中补Content-Type: application/json（否则 415 错误） - 对必填字段加注释：在
Examples的Description栏写明规则，例如"password: 6-30 chars, required"，避免协作时传错值
为什么导入后 Examples 里看不到文档里的示例值
Swagger 文档里的 example 或 examples 字段，Postman 只在极少数情况下自动映射进 Examples 面板——它只认 OpenAPI 3.x 中 requestBody.content.application/json.example 这一固定路径，且该值必须是纯 JSON 对象/数组，不能是字符串。
常见失效场景：
Postman 12.27.7 Windows x64 官方安装包，适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力，以及接口规范标签管理改进，适合受限网络测试与规范资源组织场景。
- 文档用的是
swagger: "2.0"，其example写在parameters.schema.example，Postman 不读 -
example值是字符串"{"user":"abc"}"（带转义引号），而非原生 JSON{"user":"abc"} - 用了
examples（复数）对象，但内部 key 名不是application/json，比如叫default或sample
解决办法：别依赖自动同步，导入后立刻进 Examples 手动粘贴文档里的 JSON 示例，并保存。
Pre-request Script 动态生成参数比静态示例更可靠
硬编码在 Examples 里的值，一旦接口要求 timestamp、nonce、sign 等动态字段就立即失效。此时必须用 Pre-request Script 实时生成。
例如登录接口需当前毫秒时间戳 + 随机字符串签名：
const timestamp = Date.now().toString();
const nonce = Math.random().toString(36).substr(2, 8);
pm.globals.set("req_timestamp", timestamp);
pm.globals.set("req_nonce", nonce);
// 然后在 Body JSON 里用 {{req_timestamp}} {{req_nonce}}
注意点：
- 全局变量（
pm.globals.set）跨请求生效，适合 token、base_url；环境变量（pm.environment.set）绑定当前环境，适合不同域名切换 - 脚本里不能用
console.log，调试用console.log()会报错，改用pm.test("log", () => { console.log("debug:", timestamp); });（仅限 Tests 标签）或直接看 Postman 控制台（View → Show Postman Console） - 涉及加密（如 HMAC-SHA256）需引入外部库？不行。Postman 不支持
require，只能手写简易算法或调用已内置的crypto-js（v10.17+ 自带，无需 import）
真正难的不是写脚本，而是搞清哪些字段必须每请求都变、哪些可复用、哪些要和服务端约定生成规则——这些细节往往藏在开发给的「签名说明文档」里，而不是 Swagger 中。
