导入OpenAPI JSON至Postman遇格式错误：Bearer大小写引发问题

核心原因 #

Postman内置的OpenAPI校验逻辑存在大小写强制匹配的硬限制，和IANA HTTP认证方案定义（要求使用"Bearer"）、OpenAPI规范的要求不一致——它只认小写的"bearer"，否则会触发Should not have a 'bearerformat' property without 'scheme: bearer' being set的错误。

为啥搜不到相关问题？ #

• 多数用户碰到这个问题时，直接改成小写就解决了，不会特意发帖求助；
• 很多人是通过Postman直接生成OpenAPI文档，工具自动用了小写"bearer"，根本碰不到这个冲突；
• 这个问题可能只存在于Postman的特定版本，不是全版本普遍存在的bug，所以相关讨论较少。

解决办法 #

如果想兼顾标准规范和Postman导入：

1. 临时修改OpenAPI JSON里的字段：把"scheme": "Bearer"改成"scheme": "bearer"，完成导入；
2. 导入成功后，在Postman的API定义里把认证方案的scheme改回"Bearer"即可——此时Postman内部运行不会再校验大小写，完全符合标准。

内容的提问来源于stack exchange，提问作者Tod