CodeIgniter 数据库种子文件须通过 php spark db:seed 在 CLI 下运行，Seeder 类必须继承 CodeIgniter\Database\Seeder、命名与文件名一致、实现 run() 方法；默认使用 default 数据库组，需确保命令系统启用、路径正确、环境为 CLI，多 Seeder 需手动调用且注意外键顺序，无自动事务与错误回滚。
CodeIgniter 的数据库种子文件不能直接运行，必须通过 php spark 命令触发，且仅在 CLI 环境下生效。
Seeder 类必须继承 CodeIgniter\Database\Seeder
不继承这个基类，php spark db:seed 会完全忽略该文件，连报错都不会有——它只是静默跳过。
- 类名必须与文件名一致（如
UserSeeder.php→class UserSeeder extends Seeder） -
run()方法是唯一入口，所有插入逻辑必须写在里面，不能靠构造函数或静态方法自动执行 - 不声明
protected $DBGroup = 'default';时，默认使用app/Config/Database.php中配置的default连接组
php spark db:seed 命令的常见失败原因
命令执行后无输出、表没数据、甚至提示 Command not found，大概率是以下问题之一：
- 项目未启用 Spark 命令系统：确认
app/Config/Console.php中$commands数组包含CodeIgniter\Commands\Database\Seed - Seeder 类不在
app/Database/Seeds/目录下，或命名空间未设为App\Database\Seeds - 执行时不在项目根目录（即含
spark文件的目录），或用了php -S等 Web 服务器环境（CLI 和 Web 是隔离的） - MySQL 连接失败但未抛异常：检查
app/Config/Database.php中DBDriver是MySQLi或PDO，且账号密码能直连
批量运行多个 Seeder 的顺序控制
CI4 不支持自动依赖排序，php spark db:seed 默认只跑 DatabaseSeeder，其他 Seeder 必须显式调用。
- 在
DatabaseSeeder::run()中用$this->call('UserSeeder')手动触发，字符串参数是类名（不含Seeder后缀也可，但推荐写全） - 调用顺序就是执行顺序，外键约束敏感的场景（如先插
roles再插users）必须严格按依赖关系排列 - 避免在
run()中写耗时操作（如循环插入 10 万条），CI4 的 Seeder 没有分批机制，超时或内存溢出会中断且不回滚
Seeder 文件本质是 PHP 类，不是 SQL 脚本，它和模型、查询构建器共用同一套数据库连接与事务机制。最容易被忽略的是：它不会自动开启事务，也不做任何错误恢复——哪怕某条 $this->db->table('x')->insert() 失败，后续语句照常执行。
