如何调试@graphql-codegen/cli？Schema加载失败排查求助

• 检查Node.js版本兼容性
  你看到的stream/web实验性警告，可能和Node版本有关。切换到项目之前使用的稳定Node版本（比如用nvm切换），再尝试加载Schema，确认是否是版本更新导致的兼容性问题。

• 直接测试Schema URL的可访问性
  用curl或Postman直接请求Schema URL，确认能正常返回GraphQL SDL或Introspection结果。示例命令：

  curl -X POST [你的Schema URL] -H "Content-Type: application/json" -d '{"query":"{ __schema { types { name } } }"}'
  

  如果请求失败，说明问题出在网络、权限或服务端，和代码生成工具无关。

• 核对配置文件细节
  检查代码生成工具（如GraphQL Code Generator）的配置文件（通常是codegen.ts或codegen.yml）：

  • 确认Schema URL无拼写错误
  • 检查是否遗漏必要请求头（如Authorization、API Key）
  • 本地Schema文件路径是否正确（若为本地加载模式）

• 手动生成Introspection JSON文件
  先手动获取Schema的Introspection结果并保存为本地JSON文件，再让工具加载本地文件：

  npx get-graphql-schema [你的Schema URL] --json > schema.json
  

  修改配置文件指向该本地文件，若加载成功，说明问题出在远程请求环节。

• 排查依赖包冲突或版本问题
  删除node_modules和锁文件后重新安装依赖：

  rm -rf node_modules yarn.lock
  yarn install
  

  同时检查代码生成工具相关依赖（如@graphql-codegen/cli、@graphql-codegen/typescript）的版本，尝试回退到之前能正常运行的版本。

• 启用Node.js请求追踪
  执行命令时添加NODE_DEBUG=http来查看HTTP请求细节：

  NODE_DEBUG=http yarn run [你的代码生成命令]
  

  该命令会输出详细的请求日志，包括请求发送状态、响应码、返回内容等，帮助定位问题。

• 检查网络代理或防火墙设置
  若在公司网络环境下，可能代理或防火墙拦截了请求。尝试切换到个人网络，或检查代理环境变量（HTTP_PROXY/HTTPS_PROXY）是否配置正确。

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