Realm Code-1错误：预填充Realm数据库加载失败求助

看起来你正在尝试给Swift项目集成一个预填充的Realm数据库，先帮你梳理下已做的操作：

• 准备了预填充好的Realm数据库（数据库状态截图）
• 通过拖拽方式将数据库文件添加到Xcode项目中（拖拽操作提示截图）
• 当前项目结构已包含该数据库文件（项目树截图）
• 在AppDelegate中编写了迁移相关代码，代码片段如下：

import UIKit
import RealmSwift

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    var window: UIWindow?

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // 此处迁移代码未完整展示
        return true
    }
}

结合这类场景的常见问题，我猜你大概率遇到的是预填充数据无法被App读取，启动后数据库为空的情况，下面是针对性的排查和解决步骤：

1. 先确认数据库文件是否被正确打包进App #

这是最容易踩的坑：

• 选中你的.realm文件，查看Xcode右侧的File Inspector，确保Target membership下的你的App target已经被勾选。
• 回忆拖拽文件到Xcode时，是否勾选了Copy items if needed，如果没勾选，文件不会被复制到项目目录，打包时自然不会包含。
• 确认你添加的是.realm主文件，不是.realm.lock或.realm.management这类Realm自动生成的辅助文件。

2. 手动复制预填充文件到Realm默认路径 #

Realm默认会在App的Documents目录创建数据库文件，而你放在Bundle里的预填充文件是只读的，必须复制到可读写的路径才能使用。在AppDelegate的启动方法里添加以下逻辑：

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 替换成你的预填充数据库文件名
    let prefilledDBName = "your-pre-filled-database"
    
    // 获取Realm默认路径和Bundle中的预填充文件路径
    guard let defaultRealmURL = Realm.Configuration.defaultConfiguration.fileURL,
          let bundleRealmURL = Bundle.main.url(forResource: prefilledDBName, withExtension: "realm") else {
        print("找不到预填充数据库文件")
        return true
    }
    
    // 只有当默认路径没有数据库时才复制，避免覆盖用户后续产生的数据
    if !FileManager.default.fileExists(atPath: defaultRealmURL.path) {
        do {
            // 确保父目录存在
            try FileManager.default.createDirectory(at: defaultRealmURL.deletingLastPathComponent(), withIntermediateDirectories: true)
            try FileManager.default.copyItem(at: bundleRealmURL, to: defaultRealmURL)
        } catch {
            print("复制预填充数据库失败：\(error.localizedDescription)")
        }
    }
    
    // 配置迁移（如果需要的话）
    let config = Realm.Configuration(
        schemaVersion: 1, // 要和预填充数据库的schema版本一致，或者按需升级
        migrationBlock: { migration, oldSchemaVersion in
            // 示例：如果从旧版本升级，这里写迁移逻辑
            if oldSchemaVersion < 1 {
                // 比如新增了字段，Realm会自动添加默认值，无需额外操作
            }
        }
    )
    
    // 设置默认配置
    Realm.Configuration.defaultConfiguration = config
    
    // 验证是否加载成功
    do {
        let realm = try Realm()
        print("当前Realm路径：\(realm.configuration.fileURL!)")
        // 替换成你的数据模型类，查看数据数量
        print("预填充数据数量：\(realm.objects(YourModelClass.self).count)")
    } catch {
        print("打开Realm失败：\(error.localizedDescription)")
    }
    
    return true
}

3. 验证数据模型与预填充数据库的一致性 #

如果你的Swift数据模型类和预填充数据库的schema不匹配（比如类名写错、字段类型不一致、缺少字段等），Realm会认为这是一个新的数据库，自动创建空库。你可以用Realm Studio打开预填充的.realm文件，核对模型类的每个细节。

4. 处理版本迁移问题 #

如果预填充数据库的schema版本和你当前App的版本不同，一定要在migrationBlock中编写对应的迁移逻辑，同时确保schemaVersion设置正确。如果不需要迁移，也可以显式设置schemaVersion为预填充数据库的版本号，避免Realm自动升级。

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