You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用Next.js+GraphQL-Yoga 3时/api/graphql路由404问题求助

解决GraphQL-Yoga 3 + Next.js Pages Router 404问题

核心问题是路由文件路径不匹配:
Next.js Pages Router 中,/api/graphql 路由需要对应 pages/api/graphql.tsx 文件,但你的Yoga配置代码目前放在 pages/api/index.tsx(对应 /api 路径),导致访问 /api/graphql 时找不到处理逻辑,返回404。

解决步骤:

  • 在 pages/api 目录下新建 graphql.tsx 文件
  • 将 pages/api/index.tsx 中的所有代码复制到 graphql.tsx 中
  • 删除原有的 pages/api/index.tsx 文件(或清空内容)
  • 重启Next.js开发服务器,访问 /api/graphql 即可正常加载GraphQL Playground

额外检查项:

  • 确认Yoga实例配置中未自定义修改路由路径,默认配置即可匹配 /api/graphql
  • 确保开发服务器完全重启,避免路由缓存导致的异常

内容的提问来源于stack exchange,提问作者CKW

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.21 15:32:00