如何解决gqlgen中出现的‘Error fetching schema’问题

核心原因及修复步骤 #

1. 自定义标量Timestamp未配置映射与处理逻辑 #

gqlgen默认不识别自定义标量，必须明确指定其对应的Go类型并实现序列化/反序列化逻辑。

修复方法：
编辑项目根目录的gqlgen.yml文件，添加Timestamp的类型映射：

# gqlgen.yml
models:
  Timestamp:
    # 映射到gqlgen内置的Time类型，已实现序列化逻辑
    model: github.com/99designs/gqlgen/graphql.Time
    # 或者直接映射到Go标准库的time.Time：
    # model: time.Time

2. 修改Schema后未重新生成gqlgen代码 #

自定义Schema后必须重新生成对应的model、resolver和schema执行文件，否则代码与Schema不匹配会导致服务启动失败或Schema无法被 introspect。

执行命令：

go run github.com/99designs/gqlgen generate

3. 检查服务启动日志 #

执行上述步骤后启动服务，查看控制台输出是否有报错（比如标量处理失败、Schema加载错误）。常见的报错包括：

• unknown scalar type Timestamp
• 结构体字段类型不匹配

如果存在报错，根据提示调整配置或代码。

验证步骤 #

1. 重新启动服务
2. 打开GraphQL Playground，刷新页面
3. 查看"文档"标签页，确认自定义的User、Mutation等类型已正常加载

额外说明 #

你的Resolver代码中panic(fmt.Errorf("not implemented..."))是正常的，只会在实际调用Mutation时触发，不会影响Schema的获取。只要Schema加载正常，Playground就能正确显示文档。

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