本文详解如何配置 laravel 使其错误和调试日志实时输出到容器标准输出（stdout），解决 `docker logs` 无法捕获 laravel 日志的问题，适用于 docker、kubernetes 等容器化部署场景。
默认情况下，Laravel 将日志写入 storage/logs/laravel.log 文件，而不会自动转发到 stdout 或 stderr —— 这导致 docker logs -f
✅ 步骤 1：配置 Laravel 日志通道为 stack + single（并确保不忽略异常）
修改 config/logging.php，确保 stack 通道明确包含 single，且 ignore_exceptions => false（否则命令行异常可能被静默丢弃）：
'channels' => [
'stack' => [
'driver' => 'stack',
'channels' => ['single'], // 必须显式包含 single
'ignore_exceptions' => false, // 关键！避免 Artisan 异常被跳过
],
'single' => [
'driver' => 'single',
'path' => storage_path('logs/laravel.log'),
'level' => 'debug',
'permission' => 0660,
],
],? 提示：Laravel 7+ 默认已启用 stack 通道，但若项目自定义过 logging.php，请确认上述配置存在且生效。
✅ 步骤 2：强制 Laravel 使用 stack 通道
在 .env 文件中设置：
LOG_CHANNEL=stack
运行 php artisan config:clear（或重建容器以确保环境变量生效）。该配置使所有日志（包括 Artisan 命令错误、HTTP 请求异常、队列失败等）均通过 stack 通道写入 laravel.log。
✅ 步骤 3：将日志文件实时 tail 到容器 stdout/stderr
由于 Laravel 本身不直接写 stdout，最可靠、轻量且符合 12-factor 原则的方式是：在容器启动后，后台运行 tail -f 持续输出日志文件内容到标准流。
▪ Docker Compose 场景（推荐）
在 docker-compose.yml 的 PHP 服务中添加 entrypoint 或 command（覆盖默认启动逻辑）：
services:
app:
image: travellist
# ... 其他配置
entrypoint: ["/bin/sh", "-c"]
command: |
touch /var/www/storage/logs/laravel.log &&
tail -f /var/www/storage/logs/laravel.log > /proc/1/fd/2 &
exec docker-php-entrypoint php-fpm? 说明：/proc/1/fd/2 是容器主进程（PID 1，即 php-fpm）的 stderr 文件描述符，> 重定向确保日志进入容器标准错误流，docker logs 即可捕获。
▪ Kubernetes 场景（如原答案所示）
使用 lifecycle.postStart 确保日志流在容器就绪后立即启动：
lifecycle:
postStart:
exec:
command:
- /bin/bash
- -c
- |
mkdir -p /var/www/storage/logs &&
touch /var/www/storage/logs/laravel.log &&
tail -f /var/www/storage/logs/laravel.log > /proc/1/fd/2 &⚠️ 注意事项：
- 确保日志目录权限正确（容器内用户需有读写权限）：可在 Dockerfile 中添加 RUN chown -R www-data:www-data /var/www/storage/logs
- 不要使用 tail -f 直接替代主进程（如 tail -f laravel.log 作为唯一命令），否则容器会因主进程退出而终止。
- 避免在 Dockerfile 中用 CMD ["tail", "-f", "..."]，这会覆盖 php-fpm，导致 Web 服务不可用。
✅ 验证是否生效
- 触发一次 Artisan 错误：
docker exec -it travellist-app php artisan nonexistent:command
- 实时查看容器日志：
docker logs -f travellist-app
✅ 正确输出应包含类似以下内容（而非仅 FPM 启动日志）：
[2024-06-15 10:22:33] local.ERROR: Command "nonexistent:command" is not defined. {"exception":"[object] (Symfony\\Component\\Console\\Exception\\CommandNotFoundException(code: 0): Command \"nonexistent:command\" is not defined. at /var/www/vendor/symfony/console/Application.php:644)..."}
通过以上三步，Laravel 日志即可无缝接入 Docker/K8s 原生日志收集体系（如 Fluentd、Filebeat、Elasticsearch），实现集中化、结构化与告警联动，大幅提升生产环境排障效率。
