Laravel 10安装器数据库连接更新后不生效问题排查

问题 #

使用Laravel 10开发安装器应用，需求逻辑如下：

• 未设置数据库信息时，页面跳转至数据库配置界面
• 提交配置表单后执行：
  1. 更新.env文件的数据库相关配置
  2. 执行Artisan命令清理缓存、清除配置缓存并重新缓存新配置
  3. 执行数据库迁移与数据填充

目前.env文件已成功更新（比如原数据库名ab_setup改为nn_setup），但系统仍使用旧的数据库连接信息，报错：

Unknown database 'ab_setup' (Connection: mysql, SQL: select * from information_schema.tables where table_schema = nn_setup and table_name = migrations and table_type = 'BASE TABLE').

相关代码如下：

// Update .env file content
$envContent = [
    'DB_CONNECTION' =>  $request->database_connection,
    'DB_HOST'       =>  $request->database_host,
    'DB_PORT'       =>  $request->database_port,
    'DB_DATABASE'   =>  $request->database_name,
    'DB_USERNAME'   =>  $request->database_username,
    'DB_PASSWORD'   =>  $request->database_password
];

foreach( $envContent as $key => $value ) {
    $this->replace_env_value($key, $value);
}

// Clear Cache and Config & Cache new Config
Artisan::call('cache:clear');
Artisan::call('config:clear');
Artisan::call('config:cache');

// Migrate DB and Seed
Artisan::call('migrate');
Artisan::call('db:seed');

// Create Admin User
$user = new User();
$user->name = $request->admin_name;
$user->email = $request->admin_username;
$user->password = Hash::make($request->admin_password);
$user->save();

解决方案 #

核心问题是当前请求周期内，Laravel已加载旧的.env配置到内存，更新.env后不会自动刷新当前进程的配置，同时命令执行顺序存在逻辑问题。以下是修复步骤：

1. 更新.env后，强制刷新当前请求的配置实例 #

在执行Artisan命令前，手动更新内存中的环境变量和Laravel配置实例，确保后续操作使用新的数据库信息：

// 更新.env之后添加这段代码
foreach ($envContent as $key => $value) {
    // 更新系统环境变量
    putenv("{$key}={$value}");
    $_ENV[$key] = $value;
    $_SERVER[$key] = $value;
}

// 重新初始化数据库连接配置
app()->make('config')->set('database.connections.mysql', [
    'driver' => $request->database_connection,
    'host' => $request->database_host,
    'port' => $request->database_port,
    'database' => $request->database_name,
    'username' => $request->database_username,
    'password' => $request->database_password,
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'prefix_indexes' => true,
    'strict' => true,
]);

2. 调整Artisan命令执行顺序 #

config:cache生成的配置缓存仅对下一次请求生效，当前请求无法读取，因此不需要在迁移前执行。正确顺序：

// 先清除旧的配置缓存，再清理普通缓存
Artisan::call('config:clear');
Artisan::call('cache:clear');

// 此时执行迁移会使用新的配置
Artisan::call('migrate');
Artisan::call('db:seed');

3. 验证replace_env_value方法的正确性 #

确保.env文件的替换逻辑没有疏漏，比如处理空值、引号等情况，示例实现：

private function replace_env_value($key, $value) {
    $envFile = base_path('.env');
    $content = file_get_contents($envFile);
    
    // 匹配以目标key开头的行，替换为新值
    $content = preg_replace("/^{$key}=.*/m", "{$key}={$value}", $content);
    
    // 如果.env中没有该key，追加到文件末尾
    if (!preg_match("/^{$key}=/m", $content)) {
        $content .= "\n{$key}={$value}";
    }
    
    file_put_contents($envFile, $content);
}

4. 安装完成后重定向到新请求 #

迁移和管理员用户创建完成后，通过重定向让Laravel加载新的配置（如果后续需要使用缓存配置）：

return redirect()->route('install.success');

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