Laravel 10中GraphQL Lighthouse初始化报错求助

这个错误的核心原因是GraphiQL发起请求的GraphQL API端点返回了HTML内容（比如Laravel的404页面），而非预期的JSON响应，导致解析失败。按以下步骤排查修复：

1. 验证GraphQL端点的可用性 #

直接访问你的项目GraphQL端点：http://localhost/laravel-light-graph/graphql，正常情况下应该返回类似这样的JSON错误：

{"errors":[{"message":"Must provide query string."}]}

如果返回的是HTML页面（比如404），说明路由未正确注册，继续下一步排查。

2. 确认Lighthouse路由是否加载 #

执行命令查看已注册路由：

php artisan route:list

搜索是否存在POST /graphql的路由，对应的控制器应为Nuwave\Lighthouse\Http\Controllers\GraphQLController@query。

• 若不存在该路由，检查config/app.php的providers数组中是否包含Nuwave\Lighthouse\LighthouseServiceProvider::class（Laravel 10默认自动发现，若未自动加载可手动添加）。

3. 校准项目根路径配置 #

在项目根目录的.env文件中设置正确的应用URL：

APP_URL=http://localhost/laravel-light-graph

然后清除配置缓存：

php artisan config:clear

4. 同步GraphiQL与Lighthouse的端点配置 #

重新发布GraphiQL的配置文件：

php artisan vendor:publish --tag=graphiql-config

打开config/graphiql.php，确认endpoint参数值为/graphql，与Lighthouse的路由URI一致。之后清除路由缓存：

php artisan route:clear

5. 排除CSRF中间件拦截 #

检查app/Http/Middleware/VerifyCsrfToken.php文件，确认$except数组中包含/graphql：

protected $except = [
    '/graphql',
];

Lighthouse默认已配置此项，但手动确认可避免意外拦截。

完成以上步骤后，重新访问http://localhost/laravel-light-graph/graphiql，应该能正常加载GraphiQL界面。

内容的提问来源于stack exchange，提问作者deemi-D-nadeem