Laravel 5.5中DB_HOST设为127.0.0.1/localhost的异常问题咨询

这个问题我之前帮不少开发者排查过，核心原因其实是MySQL两种连接方式的差异，再加上Laravel运行的两种环境（Web请求 vs CLI命令）的PHP配置不一致导致的，咱们一步步拆解：

1. localhost 和 127.0.0.1 的本质区别 #

MySQL客户端连接时有两种核心方式：

• 当你用localhost时，客户端默认优先尝试**Unix套接字（Socket）**连接（这是一种本地进程间通信方式，不需要通过网络端口）；
• 当你用127.0.0.1时，客户端会强制使用TCP/IP协议连接，必须通过MySQL监听的3306端口（默认）来通信。

2. 为什么两种场景下表现相反？ #

Web查询用localhost正常、127.0.0.1报错 #

说明你的Web环境的PHP配置（比如Apache/Nginx加载的php.ini）里，已经正确设置了MySQL套接字的路径，能通过Socket正常连接到MySQL；但用127.0.0.1时连接被拒，大概率是MySQL没有开启TCP/IP监听（比如my.cnf里bind-address被设为127.0.0.1以外的地址，或者被注释掉，或是防火墙拦截了3306端口）。

迁移/填充用localhost报错、127.0.0.1正常 #

这是因为CLI命令行环境的PHP配置（和Web环境的php.ini可能不是同一个文件）里，套接字路径配置错误，导致无法通过Socket连接MySQL；而用127.0.0.1时，CLI环境的PHP能通过TCP/IP正常连接（说明此时MySQL的TCP监听是正常的）。

3. 解决方案 #

你可以选以下两种方案中的任意一种来彻底解决：

方案一：统一连接方式，同步两种环境的PHP配置 #

如果你想继续用localhost（Socket连接）：

1. 先在MySQL命令行里执行show variables like 'socket';，找到MySQL实际的套接文件路径（比如/var/run/mysqld/mysqld.sock）；
2. 找到CLI环境的php.ini文件：运行php --ini，查看Loaded Configuration File那一行；
3. 打开这个php.ini，修改以下配置项，把路径改成你刚才查到的Socket路径：

   mysqli.default_socket = /var/run/mysqld/mysqld.sock
   pdo_mysql.default_socket = /var/run/mysqld/mysqld.sock
   

4. 无需重启Web服务，直接重新运行迁移命令即可。

如果你想改用127.0.0.1（TCP/IP连接）：

1. 打开MySQL的配置文件（my.cnf或my.ini，位置通常在/etc/mysql/或者C:\ProgramData\MySQL\MySQL Server X.X\）；
2. 确保bind-address设置为127.0.0.1，port设置为3306；
3. 重启MySQL服务；
4. 检查Web和CLI环境的php.ini，确保以下配置项是3306：

   mysql.default_port = 3306
   mysqli.default_port = 3306
   

方案二：在Laravel的.env里明确指定Socket路径 #

直接在.env文件里添加Socket路径，这样不管是Web请求还是CLI命令，Laravel都会用指定的Socket连接，彻底避开localhost和127.0.0.1的自动选择问题：

DB_HOST=localhost
DB_SOCKET=/var/run/mysqld/mysqld.sock

（路径替换成你实际查到的MySQL Socket路径）

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