Laravel 12 Sail部署Railway遇问题：502错误及数据库连接失败求助

1. 是否需要自定义Dockerfile？ #

是，必须自定义。Sail默认的Docker配置是为本地开发设计的，包含Xdebug、Node.js等大量开发工具，完全不适合生产环境。Railway需要适配生产场景的轻量Docker镜像，你必须编写仅包含生产运行依赖的Dockerfile，替代Sail的开发配置。

2. Laravel 12 Sail部署Railway分步指南 #

步骤1：清理本地开发配置 #

• 删除项目根目录下的docker-compose.yml（Sail本地开发专用配置），保留.env.example并移除其中Sail相关的本地环境变量。
• 在项目根目录创建生产用Dockerfile，示例如下：

FROM php:8.3-fpm-alpine

# 安装Laravel依赖的PHP核心扩展
RUN docker-php-ext-install pdo pdo_mysql

# 安装Composer
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

# 设置项目工作目录
WORKDIR /var/www/html

# 复制项目文件到镜像
COPY . .

# 安装生产环境依赖（跳过开发包）
RUN composer install --no-dev --optimize-autoloader

# 配置目录权限（适配Laravel存储/缓存需求）
RUN chown -R www-data:www-data /var/www/html/storage /var/www/html/bootstrap/cache

# 暴露PHP-FPM端口
EXPOSE 9000

# 启动服务
CMD ["php-fpm"]

注：如果需要Nginx反向代理，可以编写多阶段构建的Dockerfile，或直接在Railway中配置Nginx服务。

步骤2：配置Railway环境变量 #

• 在Railway控制台创建新项目，关联你的GitHub仓库。
• 添加Railway MySQL服务，服务创建后会自动生成以下环境变量：
  • MYSQLHOST
  • MYSQLUSER
  • MYSQLPASSWORD
  • MYSQLDATABASE
  • MYSQLPORT
• 在Railway项目的「Variables」页面添加Laravel核心环境变量：
  • APP_KEY：本地执行php artisan key:generate --show获取后粘贴
  • APP_ENV=production
  • APP_DEBUG=false
  • DB_CONNECTION=mysql
• 修改config/database.php中的MySQL配置，直接映射Railway自动生成的变量：

  'mysql' => [
      'driver' => 'mysql',
      'host' => env('MYSQLHOST', '127.0.0.1'),
      'port' => env('MYSQLPORT', '3306'),
      'database' => env('MYSQLDATABASE', 'forge'),
      'username' => env('MYSQLUSER', 'forge'),
      'password' => env('MYSQLPASSWORD', ''),
      'unix_socket' => env('DB_SOCKET', ''),
      'charset' => 'utf8mb4',
      'collation' => 'utf8mb4_unicode_ci',
      'prefix' => '',
      'prefix_indexes' => true,
      'strict' => true,
      'engine' => null,
      'sslmode' => env('DB_SSL_MODE', 'required'),
  ],
  

步骤3：部署与执行迁移 #

• 推送代码到GitHub，Railway会自动构建Docker镜像并完成部署。
• 部署完成后，在Railway控制台的项目「Shell」中执行数据库迁移：

  php artisan migrate --force
  

必须添加--force参数，生产环境禁止交互式确认操作

步骤4：配置服务启动方式 #

• 在Railway的「Settings」页面，设置「Start Command」为：

  php artisan serve --host=0.0.0.0 --port=$PORT
  

生产环境更推荐使用PHP-FPM+Nginx的组合，性能更稳定

3. 数据库连接最优方案 #

• 依赖Railway自动注入的环境变量：完全不要手动填写数据库凭据，直接映射Railway MySQL服务生成的MYSQL*系列变量到Laravel配置，彻底避免硬编码敏感信息。
• 强制启用SSL连接：Railway的MySQL服务要求SSL连接，在config/database.php中设置'sslmode' => 'required'，确保数据传输安全。
• 使用内部网络通信：Railway内部服务通过私有网络互通，直接使用MYSQLHOST提供的内部主机名即可，无需公网IP，延迟更低且更安全。
• 环境变量统一管理：所有敏感配置（如APP_KEY、数据库凭据）全部通过Railway的环境变量功能管理，本地仅保留.env.example作为配置模板。

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