Docker环境下Laravel的stderr通道日志无输出如何调试排查

按以下顺序逐层排查，优先排除高频低级问题：

• 先清Laravel配置缓存
  绝大多数配置不生效问题都是缓存导致的，先在容器内执行php artisan config:clear，不要依赖.env文件的修改结果，Laravel开启配置缓存后会完全忽略.env的动态读取。
  可以临时加测试路由验证实际加载的日志配置：

  Route::get('/debug-log-config', function () {
      dd([
          'default_channel' => config('logging.default'),
          'stderr_config' => config('logging.channels.stderr')
      ]);
  });
  

  访问该路由，确认default_channel值为stderr，且stderr通道的stream参数为php://stderr、日志级别符合预期，没有被自定义tap意外拦截。
• 直接验证stderr流可用性，排除Laravel层问题
  新增测试路由，绕过Laravel日志系统直接写stderr：

  Route::get('/test-stderr', function () {
      fwrite(STDERR, "DIRECT STDERR TEST\n");
      logger()->error('LARAVEL LOG TEST');
      return 'triggered';
  });
  

  访问该路由后如果连DIRECT STDERR TEST都看不到，问题出在PHP运行时或Docker配置层，和Laravel无关：
  • 若使用PHP-FPM运行服务，编辑fpm的www.conf配置，设置catch_workers_output = yes、error_log = /dev/stderr，默认FPM会吞掉worker进程的所有输出，不会转发到容器主进程的stderr
  • 若使用Supervisor管理FPM/队列/定时任务进程，编辑对应服务的supervisor配置，设置stdout_logfile=/dev/stdout、stderr_logfile=/dev/stderr、redirect_stderr=true，不要把日志输出到容器内的本地文件
  • 检查容器启动命令，不要存在2>/dev/null、> storage/logs/laravel.log这类把stderr重定向到空或本地文件的写法
• 检查Monolog格式化器配置
  你当前配置中formatter读取的是LOG_STDERR_FORMATTER环境变量，如果该变量被设置为不存在的类名，Monolog初始化失败会导致日志直接丢弃。临时把formatter写死为Monolog自带的行格式化器测试：

  'stderr' => [
      'driver' => 'monolog',
      'level' => env('LOG_LEVEL', 'debug'),
      'handler' => StreamHandler::class,
      'formatter' => Monolog\Formatter\LineFormatter::class,
      'with' => [
          'stream' => 'php://stderr',
      ],
  ],
  

  修改后重新清配置缓存测试。
• 验证Docker日志收集链路
  进入容器内部执行php artisan tinker，在tinker内执行fwrite(STDERR, "TINKER STDERR TEST\n")，如果容器内执行时能看到输出，但docker logs <容器ID>看不到输出，检查Docker配置：
  • 确认docker run或docker-compose配置中没有设置logging.driver: none这类禁用日志收集的参数
  • 如果是K8s等编排环境，确认容器没有配置日志路径挂载覆盖，没有把stderr重定向到emptyDir等存储卷
• 检查流写入权限
  在测试路由中打印is_writable('php://stderr')的返回结果，正常应为true，如果返回false，说明容器做了特殊安全加固，限制了运行PHP的用户（通常为www-data）对标准流的写入权限，调整容器安全策略或进程运行用户即可。

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