Laravel 11设置APP_DEBUG=false仍显示服务器错误，如何解决？

检查配置缓存 #

Laravel在生产环境会缓存配置，修改.env后需重新生成配置缓存，否则旧配置可能仍生效：

php artisan config:cache

执行完成后重启服务器（如Nginx、Apache）确保缓存生效。

确认自定义500视图的位置与内容 #

确保resources/views/errors/500.blade.php文件存在且内容正确，示例内容如下：

<!DOCTYPE html>
<html>
<head>
    <title>服务器错误</title>
</head>
<body>
    <h1>抱歉，服务器遇到了问题</h1>
    <p>我们正在尽快修复，请稍后再试。</p>
</body>
</html>

无需额外添加路由，Laravel会自动识别errors目录下的对应状态码视图。

检查异常处理逻辑 #

Laravel 11的异常处理类位于app/Exceptions/Handler.php，确保未覆盖默认生产环境异常响应逻辑：

<?php

namespace App\Exceptions;

use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
use Throwable;

class Handler extends ExceptionHandler
{
    /**
     * 注册异常处理回调
     */
    public function register(): void
    {
        $this->reportable(function (Throwable $e) {
            // 自定义日志逻辑，不要在此返回响应
        });
    }
}

若曾修改render方法，需确保生产环境返回正确视图：

public function render($request, Throwable $e)
{
    if (app()->environment('production')) {
        return response()->view('errors.500', [], 500);
    }

    return parent::render($request, $e);
}

适配API请求场景 #

若请求为API（JSON格式），Laravel默认返回JSON错误响应，可在Handler.php中统一处理：

public function render($request, Throwable $e)
{
    if (app()->environment('production')) {
        if ($request->expectsJson()) {
            return response()->json([
                'message' => '服务器错误，请稍后再试'
            ], 500);
        }

        return response()->view('errors.500', [], 500);
    }

    return parent::render($request, $e);
}

验证服务器环境变量 #

部分服务器（如共享主机）可能覆盖.env配置，需在服务器面板中确认APP_DEBUG和APP_ENV实际值为false和production。

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