如何在Laravel生产环境API中禁用详细错误信息？

一、优化现有错误响应方法 #

你当前通过环境判断调整错误信息的思路是可行的，但可以替换成Laravel官方推荐的更可靠的环境检测方式，避免env()函数在配置缓存后失效的问题：

protected function error($error, $message = '', $code = 400)
{
    $response = [
        'error' => app()->isProduction() ? '500 Server Error' : $error,
        'message' => $message ?: 'Something went wrong'
    ];

    return response()->json($response, $code);
}

二、更优方案：使用全局异常处理器 #

分散在控制器中的try-catch会增加代码冗余，Laravel的全局异常处理器（app/Exceptions/Handler.php）是更规范的实现方式，能统一管理所有异常的响应逻辑：

1. 重写render方法实现环境区分

use Illuminate\Http\JsonResponse;

public function render($request, Throwable $e)
{
    // 仅针对API请求处理
    if ($request->expectsJson()) {
        $statusCode = method_exists($e, 'getStatusCode') ? $e->getStatusCode() : 500;
        
        // 生产环境返回通用错误信息
        if (app()->isProduction()) {
            return response()->json([
                'error' => '500 Server Error',
                'message' => 'Something went wrong'
            ], $statusCode);
        }

        // 开发环境返回详细错误，可按需添加堆栈信息
        return response()->json([
            'error' => $e->getMessage(),
            'message' => 'Something went wrong',
            'trace' => $e->getTraceAsString()
        ], $statusCode);
    }

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

2. 简化控制器代码
   移除控制器中的try-catch，抛出的异常会自动被全局处理器捕获：

public function foo()
{
    $this->bar();
}

三、是否属于最佳实践？ #

这种区分环境返回错误信息的做法完全符合最佳实践：

• 生产环境：避免泄露数据库结构、业务逻辑等敏感信息，保障API安全性；
• 开发环境：提供详细错误内容，大幅提升调试效率。

而使用全局异常处理器替代分散的try-catch，更是Laravel官方推荐的最佳实践：

• 减少代码冗余，统一异常处理逻辑；
• 便于后续扩展（比如新增错误日志、报警通知等功能）。

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