Rocket应用中嵌入Diesel迁移未生效问题求助

可能原因及解决方案 #

1. 数据库连接不匹配 #

控制台显示迁移完成但无表，最常见的原因是Rocket使用的数据库连接和手动迁移的不是同一个实例。

• 检查establish_connection()中使用的DATABASE_URL环境变量，确认和手动执行diesel migration run时的变量值完全一致（避免开发库和测试库混淆）。
• 在迁移钩子中添加代码验证当前连接的数据库：

  use diesel::prelude::*;
  
  async fn run_rocket_migrations(rocket: Rocket<Build>) -> Rocket<Build> {
      let mut conn = rocket.state::<PgPool>().expect("managed database").get().unwrap();
      // 打印当前连接的数据库名
      let db_name: String = diesel::sql_query("SELECT current_database()")
          .get_result(&mut conn)
          .unwrap();
      println!("当前连接数据库: {}", db_name);
      
      run_migrations(&mut conn);
      rocket
  }
  

2. 迁移文件嵌入路径错误 #

embed_migrations!("migrations")的路径必须指向项目根目录下的migrations文件夹，否则会嵌入空的迁移集（此时Diesel会认为没有待执行迁移，直接输出成功）。

• 确认迁移目录和Cargo.toml同级，若在子目录需调整路径，比如embed_migrations!("./src/migrations")（根据实际结构修改）。
• 查看编译日志验证迁移是否被正确嵌入，无嵌入提示则说明路径有误。

3. 迁移记录已标记为完成但表未创建 #

Diesel通过schema_migrations表跟踪迁移状态，若之前迁移执行失败但被错误标记为完成，后续不会再执行该迁移。

• 手动连接数据库，查询迁移记录：

  SELECT version FROM schema_migrations;
  

• 若看到对应迁移版本（如20221113225713）但无对应表，可：
  • 执行diesel migration revert回滚后重启Rocket；
  • 或直接删除schema_migrations中对应版本的记录，再启动Rocket。

4. 连接池事务问题 #

从连接池获取的连接可能处于未提交事务中（Diesel默认会处理事务，但仍需排查）。

• 尝试改用独立连接执行迁移：

  async fn run_rocket_migrations(rocket: Rocket<Build>) -> Rocket<Build> {
      // 直接创建新连接而非从池获取
      let database_url = std::env::var("DATABASE_URL").unwrap();
      let mut conn = diesel::PgConnection::establish(&database_url).unwrap();
      run_migrations(&mut conn);
      
      rocket
  }
  

额外检查点 #

• 确认up.sql建表语句正确，手动执行diesel migration run能成功创建表（排除迁移文件语法问题）。
• 开启Rocket日志功能，检查是否有隐藏的连接池或迁移执行错误（将println替换为log::info）。

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