在Debian系统下使用ThinkPHP框架时，错误处理往往是一个容易被忽视、却又至关重要的环节。很多开发者遇到问题第一反应是“看日志”，但日志怎么配、异常怎么抓、自定义错误页面怎么弄，如果没提前规划好，调试时就会非常痛苦。下面就把这些常见的错误处理方法和配置步骤梳理一遍，希望对你有帮助。

1. 配置错误日志

让应用记录错误日志是第一步，也是最基础的一步。可以在 config/app.php 文件中指定日志路径和记录级别。比如，开启调试模式、设置日志目录、限定只记录 error 级别，这样既不会漏掉关键错误，也不会被大量 debug 信息淹没。

return [
// 应用调试模式
'app_debug' => true,
// 错误日志路径
'log_path' => storage_path() . '/logs',
// 错误日志级别
'log_level' => 'error',
];

2. 自定义错误页面

默认的报错页面太简陋，用户体验也不好。你可以针对不同的 HTTP 状态码（比如 404、500）创建专属的错误视图。例如，在 resources/views/errors/ 目录下新建 error.blade.php，然后传入状态码和错误信息，自己控制展示样式。

Error {{ $status }}
{{ $message }}

记得在 config/app.php 里配置错误视图的路径：

return [
// 错误页面路径
'error_view' => resource_path('views/errors/error'),
];

3. 使用异常处理器

ThinkPHP 内置的异常处理器很灵活，你可以在 app/Exceptions/Handler.php 中重写 report 和 render 方法。比如，对于 JSON 请求，返回结构化的错误信息（包含 message、file、line），而对于普通请求，则交给父类处理。这样既能保证 API 的规范性，又不会破坏传统页面的体验。

namespace AppExceptions;

use Exception;
use IlluminateFoundationExceptionsHandler as ExceptionHandler;

class Handler extends ExceptionHandler
{
    // 报告或记录异常
    public function report(Exception $exception)
    {
        parent::report($exception);
    }

    // 渲染异常为HTTP响应
    public function render($request, Exception $exception)
    {
        if ($request->expectsJson()) {
            return response()->json([
                'message' => $exception->getMessage(),
                'file' => $exception->getFile(),
                'line' => $exception->getLine(),
            ], $exception->getCode());
        }
        return parent::render($request, $exception);
    }
}

4. 配置错误报告

PHP 层面的错误报告也不能忽视。在 php.ini 中关闭页面显示错误（生产环境必须 display_errors = Off），同时开启日志记录，并指定日志路径和报告级别。比如统一将所有错误（E_ALL）写入 /var/log/php_errors.log，方便后续排查。

display_errors = Off
log_errors = On
error_log = /var/log/php_errors.log
error_reporting = E_ALL

5. 使用Nginx或Apache配置错误页面

最后，Web 服务器层面的错误页面也值得单独配置，这样即使 PHP 或框架完全挂掉，用户仍然能看到友好的提示。

Nginx配置示例

server {
    listen 80;
    server_name example.com;
    root /path/to/your/project;
    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ .php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    error_page 404 /error/404;
    location = /error/404 {
        root /path/to/your/project;
    }
}

Apache配置示例

    ServerName example.com
    DocumentRoot /path/to/your/project
    
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    
    ErrorDocument 404 /error/404.html
    
        SetHandler None
    

通过以上几个步骤，你在 Debian 系统下就能把 ThinkPHP 的错误处理体系搭建得比较完善了。从日志记录到异常拦截，再到自定义页面和服务器级配置，层层兜底，出问题时定位起来会轻松很多。