首页 > 文章列表 > Docker搭建Laravel环境:如何解决PHP容器中getaddrinfo failed: Name does not resolve错误?

Docker搭建Laravel环境:如何解决PHP容器中getaddrinfo failed: Name does not resolve错误?

396 2025-03-14

Docker搭建Laravel环境:如何解决PHP容器中getaddrinfo failed: Name does not resolve错误?

Docker下Laravel项目:排查getaddrinfo failed: Name does not resolve错误

在使用Docker构建Laravel开发环境时,常常会遇到网络连接问题,例如常见的getaddrinfo failed: Name does not resolve错误,通常发生在连接数据库或其他服务时。

问题场景: 假设您已使用Docker分别搭建了PHP (镜像:registry.cn-shanghai.aliyuncs.com/zjcommon/php:laravel-7.4)、Nginx和MySQL三个容器,容器间网络互通,MySQL可从宿主机和PHP容器访问。但执行php artisan migrate时,却出现getaddrinfo failed: Name does not resolve错误,无法解析主机名,数据库连接失败。

错误根源: 问题并非网络不通,而是PHP容器无法正确解析MySQL容器的地址。 需要重点检查以下两方面:

  1. 容器网络互联方式: 虽然您提到容器网络互通,但具体实现方式至关重要。是Docker默认网络、自定义网络(如bridge、host、overlay等)还是其他方案?不同的网络配置会影响容器间的访问方式。 如果使用自定义网络,务必仔细检查网络配置的正确性,以及PHP容器是否正确加入该网络。

  2. MySQL地址配置: Laravel数据库配置文件中的MySQL地址设置至关重要。 请检查配置文件中指定的MySQL地址,确保其为MySQL容器在当前网络环境下的可访问地址,而不是宿主机地址。 这可能需要使用MySQL容器的IP地址或容器名称(如果在Docker网络中已正确配置)。

    • 例如,如果MySQL容器在Docker网络中的名称为mysql_db,则配置文件应使用mysql_db作为主机名。
    • 如果使用IP地址,请确保PHP容器能够通过该IP地址访问MySQL容器。

通过仔细排查以上两点,即可有效解决getaddrinfo failed: Name does not resolve错误,顺利执行php artisan migrate命令。 请记住,检查网络配置和数据库连接字符串是解决此类问题的关键。

来源:1740803807