Xcode下C++读取xcframework内SQLite扩展库加载遇权限问题

核心原因 #

这个错误来自两个关键限制：

1. SQLite默认的安全机制会阻止加载扩展，需显式授权；
2. 主App Bundle是只读目录，真机沙箱会限制直接从内嵌Framework加载动态库。

解决步骤 #

1. 配置SQLite授权回调，允许加载扩展 #

SQLite需要手动授权才能加载扩展，你需要在打开数据库后设置授权回调函数，放行SQLITE_AUTH_LOAD_EXTENSION操作：

// 授权回调：仅允许加载扩展操作
static int sqliteAuthorizer(void* ctx, int op, const char* arg1, const char* arg2, const char* dbName, const char* triggerName) {
    if (op == SQLITE_AUTH_LOAD_EXTENSION) {
        return SQLITE_OK;
    }
    return SQLITE_DENY;
}

在打开数据库后、加载扩展前注册该授权器：

// db为已打开的sqlite3实例
sqlite3_set_authorizer(db, sqliteAuthorizer, NULL);

2. 将扩展文件复制到可读写目录 #

真机环境下，直接从只读的Framework目录加载动态库会触发沙箱限制，建议将扩展文件复制到App的可读写目录（如Documents）：

// 获取Bundle内扩展文件路径
NSString *sourcePath = [[NSBundle mainBundle] pathForResource:@"crsqlite" ofType:nil inDirectory:@"Frameworks/crsqlite.framework"];
// 获取Documents目录路径
NSString *documentsDir = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];
NSString *destPath = [documentsDir stringByAppendingPathComponent:@"crsqlite"];

NSFileManager *fileManager = [NSFileManager defaultManager];
// 仅当目标文件不存在时复制
if (![fileManager fileExistsAtPath:destPath]) {
    NSError *error;
    BOOL copySuccess = [fileManager copyItemAtPath:sourcePath toPath:destPath error:&error];
    if (!copySuccess) {
        NSLog(@"复制扩展文件失败: %@", error.localizedDescription);
        // 添加自定义错误处理逻辑
    }
}

之后使用复制后的路径加载扩展：

sqlite3_load_extension(db, destPath.UTF8String, "sqlite3_crsqlite_init", &errMsg);

额外注意事项 #

• 确保xcframework包含适配真机（arm64）和模拟器（x86_64）的架构，避免运行时崩溃；
• 扩展文件的签名必须与主App一致，否则会触发动态链接错误；
• 授权回调必须在sqlite3_load_extension之前设置，否则授权限制依然生效。

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