MongoDB Atlas GraphQL API JWT认证报错解决方案

两个报错的触发逻辑非常明确：

• 请求头未加Bearer 前缀时触发expected Authorization header with JWT (Bearer schema)，属于认证头格式不符合接口要求，该问题可通过补全前缀修正。
• 补全前缀后触发token contains an invalid number of segments，核心原因是传入的令牌字符串不符合JWT规范：标准JWT由.分隔为Header、Payload、Signature三段结构，报错场景下传入的字符串无任何.分隔符，本质是凭证类型使用错误，和请求头格式无关。

• 先确认凭证类型：eVaziLp8开头的字符串是MongoDB Atlas App Services的API Key，不是可直接用于接口认证的JWT，不能直接拼接在Bearer 后使用。
• 换取合法JWT：调用对应认证登录接口，用手里的API Key换取正式的访问令牌。请求示例如下：

  curl --request POST \
    --url https://<你的App Services应用访问域名>/auth/providers/api-key/login \
    --header 'Content-Type: application/json' \
    --data '{"key": "你持有的eVazi开头的API Key字符串"}'
  

  接口返回的access_token字段值，就是由.分隔的三段式合法JWT。
• 更新codegen.yml配置：将换取到的access_token填入请求头，不要额外加多余的转义符、嵌套引号，正确配置参考：

  schema:
    - https://<你的GraphQL API端点地址>:
        headers:
          Authorization: Bearer <上一步获取到的access_token值>
  

• 长期使用优化：App Services默认签发的access_token有效期为30分钟，如果需要长期本地执行codegen，可以配置自定义JWT认证规则签发长期有效令牌，或者写前置脚本在codegen执行前自动刷新token，避免每次手动替换。

注意：如果使用的是邮箱密码、第三方OAuth等其他认证方式，逻辑一致，都需要先走对应登录流程拿到签发的JWT access_token，再放到请求头中，不能直接使用认证流程里的静态密钥串。

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