Docker环境下Laravel中Image::make初始化URL图片失败问题排查

在Docker中运行Laravel 9.52.15 + Filament 2.17.52 + Intervention/image 2.7项目，Dockerfile已配置安装imagick与gd扩展。代码中使用\Image::make()读取图片URL（http://127.0.0.1:8085/storage/filament_banners_media/2/blue_light_1.png）时抛出NotReadableException，提示无法从给定URL初始化，但该URL在本地浏览器可正常访问。原Kubuntu 20环境下运行正常，因新环境为Kubuntu 22+PHP8.2，故改用Docker保留PHP8.1环境。已确认allow_url_fopen=On，尝试将.env中APP_URL改为http://host.docker.internal:8085后，访问该URL出现DNS_PROBE_FINISHED_NXDOMAIN错误，需排查Docker配置遗漏点及解决办法。

相关配置与日志 #

Dockerfile配置 #

FROM php:8.1.6-apache
...
RUN pecl install imagick \
    && docker-php-ext-enable imagick

RUN docker-php-ext-configure gd --with-freetype --with-jpeg --with-webp  --with-jpeg

RUN docker-php-ext-install gd

业务代码 #

try {
    \Log::info(varDump($this->bgimageFileUrl, ' -0 BannerGeneratorBuilder->generate $this->bgimageFileUrl::'));
    $this->bgImageObject = \Image::make($this->bgimageFileUrl);
} catch (\Intervention\Image\Exception\NotReadableException $e) {
    \Log::info(varDump($e->getMessage(), ' -1 BannerGeneratorBuilder->generate $e->getMessage()::'));
    return $this;
}

日志信息 #

[2023-10-21 14:36:58] production.INFO: scalar => (string) : -0 BannerGeneratorBuilder->generate $this->bgimageFileUrl:: : http://127.0.0.1:8085/storage/filament_banners_media/2/blue_light_1.png
[2023-10-21 14:36:58] production.INFO: scalar => (string) : -1 BannerGeneratorBuilder->generate $e->getMessage():: : Unable to init from given url (http://127.0.0.1:8085/storage/filament_banners_media/2/blue_light_1.png).
[2023-10-21 14:36:58] production.INFO: NULL : -10 $response:: : NULL

• 容器内127.0.0.1指向自身而非宿主机：本地浏览器访问127.0.0.1:8085是访问宿主机，但Docker容器内的127.0.0.1指向容器本身，因此容器内无法通过该URL访问宿主机服务。
• 配置正确的宿主机访问地址：
  • Linux环境下，host.docker.internal默认不生效，需启动容器时添加参数--add-host=host.docker.internal:host-gateway，让容器能解析该域名到宿主机IP；或直接使用宿主机的局域网IP（如192.168.x.x）替换127.0.0.1，同时确保宿主机8085端口未被防火墙拦截。
• 直接读取本地文件代替URL：若图片存储在容器可访问的路径下，建议使用文件路径（如storage_path('filament_banners_media/2/blue_light_1.png')）代替HTTP URL，避免网络请求问题，提升效率。
• 验证容器网络连通性：进入容器内部，执行curl http://宿主机IP:8085/storage/filament_banners_media/2/blue_light_1.png，测试是否能正常获取图片，排查网络层面问题。
• 切换Intervention/image驱动：在config/image.php中切换gd/imagick驱动，部分驱动对URL读取的支持存在差异，尝试切换后测试。

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