NAS存储的Laravel项目不同设备运行Artisan serve启动失败及数据库报错排查

问题根因与排查解决思路 #

1. 数据库连接报错解决 #

你遇到的SQLSTATE[HY000] [2002]报错核心原因是数据库连接失败：

• 当前.env中配置的DB_HOST=localhost，MySQL在连接localhost时会默认优先使用Unix Socket而非TCP/IP协议，只会在当前执行php artisan serve的设备本地查找MySQL服务的socket文件。
• 你的MySQL服务大概率部署在台式机或者NAS设备上，笔记本本地没有运行对应的MySQL服务，自然找不到对应socket文件，触发报错。

具体修复步骤：

• 先确认MySQL服务实际部署设备的内网IP，比如台式机内网IP为192.168.1.10，就将.env中的DB_HOST修改为这个IP地址
• 你配置文件中database.php的默认端口为33060，但是.env中配置的是3306，由于env配置优先级高于config默认值，该配置没问题，只需保证和MySQL实际监听的端口一致即可
• 确认MySQL服务已经开启了远程访问权限，对应监听端口已经在部署设备的防火墙中放通
• 执行php artisan config:clear清除配置缓存，确保修改的配置生效

2. 启动卡住问题解决 #

php artisan serve启动阶段会执行项目初始化逻辑，包含数据库连接校验，数据库连接超时前会一直处于等待状态，修复上述数据库连接问题后，启动卡住的问题会同步解决。

额外优化建议 #

• 跨设备访问MySQL不要使用Unix Socket连接，直接走TCP/IP协议更稳定，修改DB_HOST为实际IP后会默认走TCP协议
• 如果需要同网其他设备访问当前启动的Laravel服务，可以使用php artisan serve --host=0.0.0.0命令启动，同网设备通过当前设备的内网IP+8000端口即可访问
• 确认NAS挂载到笔记本的目录拥有读写权限，避免项目缓存、日志写入失败

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