在Railway平台部署Laravel应用时的数据库连接问题

一、本地无法执行mysql命令的解决方法 #

• 确认MySQL客户端安装完整性：检查MySQL安装目录的bin文件夹（如C:\Program Files\MySQL\MySQL Server 8.0\bin）是否存在mysql.exe，若缺失，重新安装MySQL并勾选「MySQL Client」组件。
• 配置系统环境变量：将上述bin文件夹路径添加到系统环境变量的Path中，添加完成后重启命令提示符，再执行mysql命令测试。

二、部署后Laravel无法连接数据库的解决方法 #

1. 核对Railway环境变量配置 #

• 登录Railway控制台进入Laravel应用，查看「Variables」页面：
  • 确保存在Railway自动注入的数据库变量：DB_HOST=viaduct.proxy.rlwy.net、DB_PORT=19736、DB_DATABASE=portfolio、DB_USERNAME=root、DB_PASSWORD=你的数据库密码
  • 若使用DATABASE_URL变量，需保证格式正确：mysql://root:密码@viaduct.proxy.rlwy.net:19736/portfolio
• 确认Laravel的.env文件（或Railway设置的环境变量）无硬编码错误地址，所有配置均读取环境变量。

2. 验证Laravel数据库配置文件 #

打开config/database.php，检查mysql连接配置是否正确读取环境变量：

'mysql' => [
    'driver' => 'mysql',
    'host' => env('DB_HOST', '127.0.0.1'),
    'port' => env('DB_PORT', '3306'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    // 其他默认配置...
],

3. 重启Railway应用实例 #

修改环境变量或配置文件后，在Railway应用控制台点击「Restart」按钮，确保新配置生效。

4. 检查Railway数据库网络权限 #

Railway内部应用与数据库默认通过私有网络连通，无需额外配置公网权限。若手动修改过数据库网络设置，需恢复默认配置，确保应用所在项目能访问数据库服务。

内容的提问来源于stack exchange，提问作者Oluwagbemiga Sunday Stephen