解决GraphQL Codegen连接被拒绝：Schema加载错误的调试与配置-js教程-PHP中文网

解决GraphQL Codegen连接被拒绝：Schema加载错误的调试与配置

DDD

发布： 2025-11-07 13:55:39

原创

299人浏览过

解决GraphQL Codegen连接被拒绝：Schema加载错误的调试与配置

本文详细介绍了graphql codegen在执行时遇到`connect econnrefused`错误的原因及解决方案。当`graphql-codegen`无法连接到指定的graphql服务端口加载schema时，通常是由于服务未运行或配置中的schema地址不正确。教程将指导您检查graphql服务状态、核对`codegen.yml`配置中的schema url，并提供正确的配置示例，确保代码生成过程顺利进行。

GraphQL Codegen Schema加载错误分析与解决

GraphQL Code Generator（graphql-codegen）是一个强大的工具，它能根据您的GraphQL Schema和操作定义自动生成类型、钩子和其他代码，极大地提升开发效率。然而，在执行graphql-codegen命令时，开发者有时会遇到connect ECONNREFUSED错误，这通常表示代码生成器无法成功连接到指定的GraphQL服务端口以加载Schema。

错误现象解读

当您运行yarn graphql-codegen或类似的命令时，如果出现如下错误信息：

✔ Parse Configuration
⚠ Generate outputs
  ❯ Generate to src/gql/
    ✖
      Failed to load schema from http://localhost:4000:
      connect ECONNREFUSED 127.0.0.1:4000
      Error: connect ECONNREFUSED 127.0.0.1:4000
      ...
error Command failed with exit code 1.

登录后复制

核心错误在于Failed to load schema from http://localhost:4000:和connect ECONNREFUSED 127.0.0.1:4000。

Failed to load schema from ...：明确指出graphql-codegen未能从指定的URL获取GraphQL Schema。
connect ECONNREFUSED：这是一个操作系统级别的网络错误，表示客户端（graphql-codegen）尝试连接到服务器（http://localhost:4000）时，连接被目标机器主动拒绝。这通常意味着：
1. 目标服务器在该地址和端口上没有运行任何服务。
2. 目标服务器正在运行，但其配置不允许来自当前IP的连接。
3. 防火墙阻止了连接。
4. 指定的地址或端口不正确。

根本原因

结合graphql-codegen的工作原理，最常见的根本原因是：

GraphQL服务未运行： graphql-codegen尝试连接的http://localhost:4000上的GraphQL服务器尚未启动或已崩溃。
Schema URL配置错误： graphql-codegen的配置文件（例如codegen.yml）中指定的GraphQL Schema端点URL（http://localhost:4000）与实际运行的GraphQL服务地址不匹配。

解决方案

解决此问题主要围绕确保graphql-codegen能够访问到正确的GraphQL Schema。

1. 验证GraphQL服务状态

在尝试运行graphql-codegen之前，请务必确认您的GraphQL后端服务已经成功启动，并且正在监听graphql-codegen配置中指定的地址和端口。

检查服务日志： 查看您的GraphQL服务（例如Apollo Server, Express-GraphQL等）的控制台输出，确认它已成功启动并显示监听的端口。
手动测试连接： 您可以使用浏览器访问http://localhost:4000/graphql（如果这是您的GraphQL Playground或GraphiQL端点），或者使用curl命令测试：
```
curl -X POST -H "Content-Type: application/json" --data '{"query":"{ __typename }"}' http://localhost:4000/graphql
```
登录后复制
如果服务正常运行，您应该会收到一个有效的GraphQL响应。如果收到连接错误，则说明您的GraphQL服务确实未运行或无法访问。

白瓜面试
白瓜面试 - AI面试助手,辅助笔试面试神器

40

查看详情

2. 检查并修正graphql-codegen配置

graphql-codegen通过配置文件（通常是codegen.yml或graphql.config.js）来获取Schema的来源。您需要仔细检查该文件中的schema字段。

示例 codegen.yml 配置：

overwrite: true
schema: "http://localhost:4000/graphql" # <-- 检查这一行
documents: "src/**/*.graphql"
generates:
  src/gql/:
    preset: client
    plugins:
      - typescript
      - typescript-operations
      - typescript-react-apollo # 或其他客户端插件
    config:
      withHooks: true
      withHOC: false
      withComponent: false

登录后复制

修正步骤：

定位配置文件： 找到项目根目录下的codegen.yml、codegen.ts、graphql.config.js等文件。
检查 schema 字段： 确认schema字段的值与您实际运行的GraphQL服务地址和端口完全一致。
- 如果您的GraphQL服务运行在http://localhost:3001/api/graphql，那么schema字段应设置为"http://localhost:3001/api/graphql"。
- 注意端口号、路径（/graphql, /api, /等）以及是否使用了HTTPS。
保存并重试： 修改配置文件后保存，然后再次运行yarn graphql-codegen命令。

3. 其他Schema来源选项

graphql-codegen支持多种Schema加载方式，如果您的后端服务不可用或您想使用静态Schema，可以考虑以下选项（错误日志中也有提示）：

本地Schema文件： 如果您有一个本地的.graphql文件或.json文件包含Schema定义，可以直接指向它。
```
schema: "./schema.graphql" # 指向本地Schema文件
```
登录后复制
Introspection JSON文件： 您可以从运行中的GraphQL服务下载一个内省（Introspection）JSON文件，然后指向该文件。
```
schema: "./graphql-schema.json" # 指向内省JSON文件
```
登录后复制
多文件定义： 使用glob表达式指定多个.graphql文件。
```
schema: "src/**/*.graphql"
```
登录后复制

注意事项

启动顺序： 始终确保您的GraphQL后端服务在运行graphql-codegen命令之前已经启动并可用。
端口冲突： 确保没有其他应用程序占用了GraphQL服务所需的端口。
防火墙： 如果您在远程服务器上运行或有严格的本地防火墙设置，请检查防火墙规则是否允许graphql-codegen进程进行网络连接。
环境变量： 如果您的Schema URL包含环境变量，请确保这些变量在执行graphql-codegen命令的环境中已正确设置。
代理： 如果您通过代理访问GraphQL服务，请确保graphql-codegen环境中的代理设置正确。

总结

connect ECONNREFUSED错误在graphql-codegen中几乎总是指向一个简单的连接问题：要么GraphQL服务未运行，要么graphql-codegen配置中的Schema URL不正确。通过系统地检查GraphQL服务的运行状态和codegen.yml中的schema配置，您可以迅速定位并解决这个问题，确保代码生成过程顺利进行。

以上就是解决GraphQL Codegen连接被拒绝：Schema加载错误的调试与配置的详细内容，更多请关注php中文网其它相关文章！