Backpack安装失败：执行php artisan migrate触发数组转字符串错误

架构老林

2026-6-20

问题排查与解决方案

错误根源分析

Array to string conversion 报错出现在 Illuminate/Database/Schema/Builder.php:163，Laravel 10 中该位置代码负责获取数据库名称并进行字符串操作，说明某个环节返回了数组而非预期的字符串，结合你的场景，大概率是数据库配置或迁移文件参数错误。

分步排查与修复

1. 检查数据库配置

打开 .env 文件，确认 DB_DATABASE 是纯字符串格式，示例：
```
DB_DATABASE=your_database_name
```
避免写成 DB_DATABASE=[your_db] 或包含多余符号的格式。
打开 config/database.php，找到 MySQL 连接配置段，确保 database 字段是字符串类型：
```
'mysql' => [
    // ... 其他配置
    'database' => env('DB_DATABASE', 'forge'),
    // ... 其他配置
],
```
禁止将该值设为数组（比如误写为 'database' => [env('DB_DATABASE')]）。

2. 清除配置缓存

执行命令刷新配置缓存，避免旧配置残留：

php artisan config:clear

3. 验证数据库连接返回值

通过 tinker 直接检查数据库名称的返回类型：

php artisan tinker

在交互模式中输入：

DB::connection()->getDatabaseName();

如果返回数组：说明配置存在问题，回到步骤1修正；
如果返回字符串：问题出在迁移文件。

4. 检查迁移文件

首先重新发布 Backpack 官方迁移文件，避免安装过程中文件损坏：
```
php artisan vendor:publish --tag=backpack-crud-migrations --force
```
检查所有迁移文件（包括项目根目录 database/migrations/ 和 Backpack 自带的 vendor/backpack/crud/src/database/migrations/），重点排查字段定义是否误用数组参数，比如：
错误写法：
```
$table->string(['username']);
```
正确写法：
```
$table->string('username');
```