Android中如何重命名Realm数据库文件？

直接IO修改文件名（推荐方案） #

直接修改文件名是可行的，但必须满足一个关键前提：所有关联的Realm实例必须完全关闭，包括已打开的Realm对象、查询结果、通知监听器等都要释放，否则直接操作文件名会导致数据库损坏、读写失败等问题。

操作步骤：

1. 彻底关闭Realm实例：
   • Android：调用所有打开的Realm对象的close()方法，确保没有残留的引用。
   • iOS：确保Realm实例的引用被完全释放（ARC环境下无需手动调用close，但要确认没有强引用持有）。
2. 重命名数据库文件及关联辅助文件：
   Realm数据库会生成几个配套文件（如abc.realm.lock、abc.realm.management、abc.realm.log等），这些文件需要和主数据库文件一起重命名，保持前缀一致。比如要改成new_db.realm，则配套文件要改为new_db.realm.lock、new_db.realm.management等。
   • 终端命令示例：

     mv abc.realm new_db.realm
     mv abc.realm.lock new_db.realm.lock
     mv abc.realm.management new_db.realm.management
     

   • 代码层面可通过对应平台的文件API实现（如Java的Files.move()、Swift的FileManager.default.moveItem()）。
3. 后续初始化Realm时指定新文件名：
   • Android示例：

     RealmConfiguration config = new RealmConfiguration.Builder()
         .name("new_db.realm")
         .build();
     Realm realm = Realm.getInstance(config);
     

   • iOS示例：

     guard let fileURL = Realm.Configuration.defaultConfiguration.fileURL?.deletingLastPathComponent().appendingPathComponent("new_db.realm") else {
         // 处理路径获取失败
         return
     }
     let config = Realm.Configuration(fileURL: fileURL)
     let realm = try! Realm(configuration: config)
     

迁移无法实现文件名修改 #

Realm的迁移机制仅用于处理数据模型结构变更（比如新增字段、修改字段类型、删除表等），和文件名修改完全无关，不要尝试用迁移来做这件事，这是对迁移功能的误用。

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