本地数据库如何正确配置以部署到Heroku？Laravel ClearDB报错500解决

1. 先定位具体错误原因 #

• 优先通过Heroku CLI查看运行日志定位问题，执行命令：heroku logs --tail，确认报错是否和数据库连接、表不存在、权限不足相关
• 临时调试可在Heroku后台Config Vars中添加APP_DEBUG=true，访问报错地址查看具体错误信息，定位完成后务必改回APP_DEBUG=false避免泄露敏感信息

2. 配置ClearDB对应环境变量 #

ClearDB安装完成后会自动生成CLEARDB_DATABASE_URL环境变量，格式为mysql://用户名:密码@主机地址/数据库名?reconnect=true，需手动拆解后添加以下参数到Heroku的Config Vars中：

• DB_CONNECTION=mysql
• DB_HOST：填入CLEARDB_DATABASE_URL中@符号后、/符号前的主机地址
• DB_PORT=3306
• DB_DATABASE：填入CLEARDB_DATABASE_URL中/符号后、?符号前的数据库名称
• DB_USERNAME：填入CLEARDB_DATABASE_URL中mysql://后、:符号前的用户名
• DB_PASSWORD：填入CLEARDB_DATABASE_URL中:符号后、@符号前的密码

3. 调整字符集兼容配置 #

ClearDB默认不支持Laravel默认的utf8mb4字符集，需修改项目中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', ''),
    'charset' => 'utf8',
    'collation' => 'utf8_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
],

4. 执行数据库迁移 #

修改完成后将代码提交到Git仓库并推送到Heroku，随后在本地终端执行Heroku端的迁移命令：

• 执行表结构迁移：heroku run php artisan migrate
• 若有初始测试数据需要填充，额外执行：heroku run php artisan db:seed
• 迁移无报错后，执行heroku run php artisan config:clear清理配置缓存

5. 异常兜底排查 #

• 确认ClearDB实例运行状态正常，无欠费、资源超限问题
• 确认项目代码中无硬编码的数据库配置覆盖env参数
• 重新核对所有Config Vars参数的拼写、取值是否正确

内容的提问来源于stack exchange，提问作者Rajaruban Rajindram