Vapor4部署到Heroku后DATABASE_URL配置错误功能异常如何解决？

问题核心 #

你当前的数据库配置硬编码了本地PostgreSQL连接参数，部署到Heroku时没有读取平台自动注入的DATABASE_URL环境变量，导致应用无法连接线上数据库，所有需要读写数据库的操作都会失效。

修复步骤 #

1. 替换数据库配置逻辑 #

修改configure函数中的数据库注册代码，适配线上和本地两套环境：

// 替换原来的 app.databases.use(...) 代码块
if let dbURLStr = Environment.get("DATABASE_URL"), let dbURL = URL(string: dbURLStr) {
    do {
        // 解析Heroku提供的数据库连接URL
        var pgConfig = try PostgresConfiguration(url: dbURL)
        // Heroku PostgreSQL要求开启TLS连接，跳过证书校验适配平台规则
        pgConfig.tlsConfiguration = .makeClientConfiguration()
        pgConfig.tlsConfiguration?.certificateVerification = .none
        app.databases.use(.postgres(configuration: pgConfig), as: .psql)
    } catch {
        fatalError("数据库配置解析失败: \(error)")
    }
} else {
    // 本地开发环境沿用原有配置
    app.databases.use(.postgres(
        hostname: "localhost",
        username: "postgres",
        password: "",
        database: "template1"
    ), as: .psql)
}

2. 配置自动执行数据库迁移 #

在项目根目录的Procfile中添加release阶段指令，确保部署时自动运行Fluent迁移：

release: App migrate --yes
web: App serve --env production --hostname 0.0.0.0 --port $PORT

3. 配置验证 #

部署完成后可通过Heroku CLI查看环境变量是否存在：
heroku config:get DATABASE_URL --app 你的应用名称
如果返回正常的连接字符串说明平台配置无误，启动报错可通过heroku logs --app 你的应用名称查看具体错误信息。

内容的提问来源于stack exchange，提问作者吳朋哲