Laravel 11 升级后日志与监控配置调整【运维监控】-php教程-PHP中文网

laravel 11 日志与异常处理需重构配置：确认 default 通道有效、清除并重缓存配置、修复 daily 轮转路径与权限、独立配置 slack 通道级别、迁移异常处理至 bootstrap/app.php 的 withexceptions()、启用 pail 实时监听关键日志。

laravel 11 升级后日志与监控配置调整【运维监控】

升级 Laravel 11 后，日志通道配置失效、监控告警静默丢失、daily 日志不再按天轮转、Slack 通知收不到——这些不是环境问题，而是 Laravel 11 对日志系统和异常处理中枢做了结构级重构，旧配置在新版本中被忽略或行为变更。

确认日志通道是否真正生效

第一步：检查 config/logging.php 中的 'default' 键值是否明确指向一个真实存在的通道名，例如 'daily' 或 'single'，【不能是 stack 而其 channels 数组为空】。

第二步：运行 php artisan tinker → Log::debug('test') → 立即检查 storage/logs/ 下对应文件是否新增内容。若无输出，说明通道未启用或路径不可写。

第三步：执行 php artisan config:clear && php artisan config:cache，确保 .env 中 LOG_CHANNEL 的值已注入配置缓存；【APP_ENV=production 时，LOG_LEVEL 默认为 error，debug 级别日志会被直接丢弃】。

修复 daily 日志不轮转或文件堆积问题

方法一：确认 'daily' 通道配置中包含 'days' => 30（或其他正整数），且 'path' 指向 storage_path('logs/laravel.log') —— Monolog 的 RotatingFileHandler 仅在此路径基础上拼接日期后缀，不支持自定义前缀。

方法二：检查 storage/logs 目录权限，PHP 进程必须对父目录有写+执行权限（chmod 755），否则无法创建 laravel-2026-08-06.log 新文件，导致所有日志仍写入 laravel.log。

方法三：手动触发轮转验证：清空 storage/logs → 设置 APP_DEBUG=true → 发起一次报错请求 → 查看是否生成带日期的新文件。若仍失败，说明 daily 驱动未被正确加载，需检查 config/logging.php 中该通道是否被注释或拼写错误。

重配 Slack 告警通道并验证连通性

第一步：在 config/logging.php 的 'channels' 数组中添加独立 slack 通道，驱动为 'slack'，必须填写 'url'（Slack Webhook URL）和 'username'（可选）。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

第二步：确保该通道的 'level' 设为 'error' 或更低（如 'warning'），否则 Log::error() 不会触发发送；【stack 通道中嵌套的 slack 若 level 高于实际日志级别，将完全静默】。

第三步：执行 php artisan log:tail → 在另一终端运行 Log::channel('slack')->error('test alert') → 观察 Slack 频道是否收到消息。若无响应，检查 Webhook URL 是否过期或网络策略拦截 POST 请求。

迁移异常处理逻辑至 bootstrap/app.php

第一步：删除 app/Exceptions/Handler.php 文件（Laravel 11 默认不生成此文件），若保留则其 report() 和 render() 方法将被完全忽略。

第二步：打开 bootstrap/app.php，在 withExceptions() 闭包内注册 report 回调：
→ use Illuminate\Contracts\Logging\Log;
→ ->withExceptions(function (Illuminate\Foundation\Exceptions\Handler $handler) {
$handler->report(function (Throwable $e) {
if ($e instanceof \App\Exceptions\PaymentFailedException) {
Log::channel('slack')->error('支付失败', ['code' => $e->getCode()]);
return false;
}
});
});

第三步：在 report 回调中调用 return false 可终止后续默认日志记录，避免重复落库；【未显式 return false 的异常仍会进入 config/app.php 中定义的 log_channel】。