在Rails 5 API中使用GraphQL-Ruby并运行GraphiQL界面的问题

别担心，这个问题其实挺普遍的！Rails在API模式下确实会默认跳过GraphiQL的自动配置，但既然你已经手动安装了graphiql-rails gem，只需要几步简单配置就能用上它了：

1. 确保gem安装完成 #

先确认你已经执行过安装命令：

bundle install

2. 添加GraphiQL路由 #

API模式的config/routes.rb里没有默认的GraphiQL路由，你需要手动添加。建议只在开发环境下挂载，避免生产环境暴露调试界面：

Rails.application.routes.draw do
  # 这里放你的其他API路由，比如资源路由、自定义端点等

  # 仅在开发环境挂载GraphiQL
  if Rails.env.development?
    mount GraphiQL::Rails::Engine, at: "/graphiql", graphql_path: "/graphql"
  end
end

• at: "/graphiql"：设置你访问GraphiQL的路径，比如http://localhost:3000/graphiql
• graphql_path: "/graphql"：指定你的GraphQL API端点路径，如果你自定义了这个路径，记得改成对应的地址

3. 确认GraphQL端点已配置 #

如果还没设置GraphQL的核心路由，需要在routes.rb里添加执行端点：

post "/graphql", to: "graphql#execute"

对应的GraphqlController可以参考graphql-ruby的默认生成代码，确保它能正常处理GraphQL请求。

4. 处理Assets加载问题（可选） #

Rails API模式默认会禁用Assets管道，而graphiql-rails需要加载静态资源才能正常显示界面。如果访问时出现样式或脚本加载失败的情况，打开config/environments/development.rb，添加以下配置：

# 启用Assets管道（仅开发环境）
config.assets.enabled = true

# 预编译GraphiQL所需的资源
config.assets.precompile += %w( graphiql/rails/application.css graphiql/rails/application.js )

5. 重启服务器 #

最后，重启你的Rails开发服务器，然后访问http://localhost:3000/graphiql，就能看到熟悉的GraphiQL调试界面啦！

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