Laravel 8连接Oracle 12执行迁移报Undefined index: user错误如何解决

• Laravel默认的数据库连接配置中，用户名字段使用的键名为username，但Doctrine DBAL组件的Oracle驱动在获取当前连接的数据库用户时，读取的是连接参数里的user键，二者键名不匹配导致索引不存在报错。
• 部分迁移可正常执行的原因是：Laravel原生的新增表、新增字段等操作不需要依赖DBAL组件，只有当迁移中使用了change()、renameColumn()这类修改已有列属性的操作时，才会调用DBAL组件，因此执行到包含这类操作的迁移时才会触发报错。

最简便的修复方式是修改Oracle连接的配置参数，补全DBAL需要的user键：

1. 打开项目的config/database.php文件，找到你的Oracle连接配置块，新增user配置项即可，示例如下：

'oracle' => [
    'driver'         => 'oracle',
    'host'           => env('DB_HOST', ''),
    'port'           => env('DB_PORT', '1521'),
    'database'       => env('DB_DATABASE', ''),
    'username'       => env('DB_USERNAME', ''),
    'password'       => env('DB_PASSWORD', ''),
    // 新增下面这行，值和username保持一致即可
    'user'           => env('DB_USERNAME', ''),
    'charset'        => env('DB_CHARSET', 'AL32UTF8'),
    'prefix'         => env('DB_PREFIX', ''),
    'prefix_schema'  => env('DB_SCHEMA_PREFIX', ''),
    'server_version' => env('DB_SERVER_VERSION', '12c'),
],

2. 配置修改完成后，重新执行php artisan migrate命令即可继续完成剩余迁移。

如果不想修改配置文件，也可以选择重写Oracle驱动的getDatabase方法适配Laravel的username键，但该方案复杂度更高，非必要不推荐。

额外注意：如果使用yajra/laravel-oci8扩展包对接Oracle，需要确保安装的扩展包版本和Laravel 8适配，即使用8.x版本的yajra/laravel-oci8，避免版本不兼容引发其他问题。

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