laravel 11升级后需立即配置stack日志通道并启用context-aware日志捕获，检查flysystem v3、路由缓存弃用及request空值异常，通过grep筛查和实时tail脚本监控关键错误。
升级 Laravel 11 后，日志中可能混入新版本引入的底层异常（如 Flysystem v3 文件系统变更导致的 Storage 异常、Route Caching 兼容性警告、或 IlluminateHttpRequest 构造逻辑调整引发的空值错误），需立即建立可定位、可过滤、可告警的日志监控路径，避免故障静默蔓延。
确认日志通道是否已切换为 stack
打开 config/logging.php，检查 default 键值是否为 'stack'。Laravel 11 默认启用 stack 通道，若仍为 'single' 或 'daily'，则无法聚合多来源错误，会导致 Horizon 或第三方日志服务漏采关键异常。
执行命令验证当前生效通道：php artisan tinker --execute "echo config('logging.default');"，输出必须是 stack。
配置 stack 通道聚合关键驱动
在 config/logging.php 的 channels.stack 配置块中，确保 channels 数组包含以下三项：
['single', 'stderr', 'papertrail'] —— 其中 single 保留本地磁盘日志用于紧急排查；stderr 将错误直接输出至 PHP-FPM 或 Supervisor 的标准错误流，便于容器日志采集；papertrail（或你实际使用的远程服务如 Sentry、Datadog）负责集中告警。
若缺少 stderr，PHP-FPM worker 崩溃时将无任何错误痕迹；若仅保留 single，线上突发流量导致磁盘 I/O 阻塞时，日志写入会静默失败。
启用 Laravel 11 新增的 context-aware 日志捕获
Laravel 11 的 Log 门面默认支持自动注入请求上下文（如 route name、user id、ip），但需手动开启：
在 app/Providers/AppServiceProvider.php 的 boot() 方法中添加：
Log::useContext(function () { return ['route' => request()->route()?->getName() ?? 'none', 'user_id' => auth()->id() ?? null, 'ip' => request()->ip()]; });
这一步不可跳过：未设置时，所有日志条目丢失路由与用户标识，面对“某接口大量 500”问题，你将无法区分是登录态失效还是订单创建逻辑崩溃。
用 grep 快速筛查 Laravel 11 特有错误关键词
进入日志目录（通常是 storage/logs），运行：
grep -r "Flysystem\V3" ./laravel*.log → 检查是否出现 FlysystemV3UnableToReadFile 类异常，这是 Laravel 11 升级后最常见的 Storage 兼容问题。
grep -r "Route caching.*deprecated" ./laravel*.log → 若存在该提示，说明你仍在使用已被标记废弃的 php artisan route:cache，需立即替换为 php artisan optimize:clear && php artisan view:cache。
grep -A 5 -B 5 "Illuminate\Http\Request.*null" ./laravel*.log → 定位因 Laravel 11 中 Request 构造函数强化非空校验而抛出的 TypeError，常见于自定义中间件中未校验 $request->query() 返回值。
部署实时 tail + 过滤脚本监控生产日志
创建脚本 monitor-l11-errors.sh：
第一步：赋予执行权限 → chmod +x monitor-l11-errors.sh
第二步：写入内容：
#!/bin/bash<br>LOG_PATH="./storage/logs/laravel-$(date +%Y-%m-%d).log"<br>if [ ! -f "$LOG_PATH" ]; then LOG_PATH="./storage/logs/laravel.log"; fi<br>tail -f "$LOG_PATH" | grep --line-buffered -E "(ERROR|CRITICAL|Exception|Flysystem\\V3|UnableToReadFile|TypeError.*Request)"
第三步：后台运行 → nohup ./monitor-l11-errors.sh > /dev/null 2>&1 &
该脚本会持续输出含关键词的新日志行，注意：不要在 Supervisor 中长期运行此脚本，仅用于上线后前2小时人工盯屏；长期监控应交由 Papertrail 或 Datadog 的 log parsing 规则处理。
