Docker容器中Laravel应用UDP连接失败问题求助

问题根源 #

错误日志显示Monolog的SocketHandler尝试连接格式错误的UDP地址udp://:，说明Laravel的日志配置中存在空的UDP主机/端口配置，导致无法解析地址，触发异常使PHP进程退出。

解决步骤 #

1. 检查日志配置文件 #

进入对应的Laravel项目容器（gateway或services服务），查看config/logging.php文件：

# 进入gateway容器
docker-compose exec gateway bash
# 查看日志配置
cat config/logging.php

查找使用udp驱动的日志通道，确认host和port参数是否为空或格式错误。例如：

'udp' => [
    'driver' => 'udp',
    'host' => env('LOG_UDP_HOST', ''), // 这里如果env返回空就会导致错误
    'port' => env('LOG_UDP_PORT', ''),
    'level' => 'debug',
],

2. 验证环境变量配置 #

检查项目根目录的.env文件，确认日志相关的环境变量是否正确设置：

# 确保这两个变量有有效值
LOG_UDP_HOST=your-udp-log-server-ip
LOG_UDP_PORT=514

如果之前运行正常，可能是.env文件被误修改，或docker容器未正确加载环境变量。

3. 清理配置缓存 #

Laravel可能缓存了旧的配置，执行以下命令清除缓存：

# 在容器内执行
php artisan config:clear
php artisan cache:clear
# 或者用Laravel Sail命令（如果用Sail）
./vendor/bin/sail artisan config:clear

4. 临时恢复应用（可选） #

如果暂时无法定位UDP配置问题，可以先切换日志驱动为file，确保应用正常运行：
修改config/logging.php中的默认日志通道：

'default' => env('LOG_CHANNEL', 'stack'),
// 或者直接指定为file
'default' => 'file',

或者注释掉UDP相关的日志通道配置，重启容器后应用即可恢复。

5. 检查Docker环境变量传递 #

确认docker-compose.yml中服务的environment配置是否正确传递了环境变量，确保容器能读取到.env中的参数。例如，检查是否包含APP_ENV、LOG_CHANNEL等关键变量。

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