Laravel项目中SQLite提示categories表不存在问题求助

1. 先确认迁移文件与执行状态 #

• 检查database/migrations目录下是否存在创建categories表的迁移文件，文件名需符合YYYY_MM_DD_HHMMSS_create_categories_table.php格式。
• 打开迁移文件，确保up()方法内的建表逻辑正确，示例：

  public function up()
  {
      Schema::create('categories', function (Blueprint $table) {
          $table->id();
          $table->string('name');
          $table->timestamps();
      });
  }
  

• 重新执行迁移命令，观察是否有报错：

  php artisan migrate
  

  若之前迁移失败，可尝试回滚后重新迁移：

  php artisan migrate:rollback
  php artisan migrate
  

  或者直接重置数据库（会清空所有数据）：

  php artisan migrate:fresh
  

2. 验证数据库表是否实际存在 #

• 用SQLite可视化工具（如DB Browser for SQLite）打开项目中的SQLite文件（默认路径database/database.sqlite），直接查看是否存在categories表。
• 若工具中也看不到表，说明迁移未真正执行成功，需排查迁移命令的报错信息。

3. 检查模型与Tinker调用逻辑 #

• 确认Category模型未指定错误表名：

  class Category extends Model
  {
      // Laravel默认会按模型单数推断表复数，若手动设置需确保正确
      protected $table = 'categories';
  }
  

• 检查Tinker中的调用代码是否正确，示例：

  App\Models\Category::factory()->count(10)->create();
  

• 重启Tinker会话——Tinker会缓存类信息，关闭当前窗口后重新执行php artisan tinker再尝试。

4. 彻底清理缓存与验证数据库配置 #

• 执行全量缓存清理，覆盖所有可能的缓存残留：

  php artisan optimize:clear
  

• 在Tinker中验证数据库配置路径是否正确：

  // 输出SQLite数据库文件路径，与实际文件路径比对
  config('database.connections.sqlite.database')
  

• 检查.env文件中的配置，确保DB_CONNECTION=sqlite，DB_DATABASE指向正确的文件路径（相对路径或绝对路径均可）。

5. 检查文件权限 #

• 确保命令行用户对database目录和database.sqlite文件有读写权限，Linux/macOS下可执行：

  chmod -R 755 database/
  chmod 644 database/database.sqlite
  

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