在Swift中调用C库retro_load_game时触发EXC_BAD_ACCESS崩溃求助

我正尝试将VICE模拟器的libretro核心（vice_x64sc_libretro_ios.dylib）集成到iOS Swift应用中，通过dlsym()动态加载核心提供的retro_load_game函数，但调用该函数时出现EXC_BAD_ACCESS崩溃。

C端函数与结构体定义 #

从VICE模拟器源码可知，目标函数及结构体定义如下：

retro_load_game函数 #

bool retro_load_game(const struct retro_game_info *game);

retro_game_info结构体 #

struct retro_game_info {
   const char *path;  // UTF-8 encoded file path
   const void *data;  // Memory buffer of the game file (NULL if fullpath mode is used)
   size_t size;       // Size of the memory buffer
   const char *meta;  // Meta information (NULL if not used)
};

Swift实现代码 #

我加载.dylib并获取retro_load_game的指针，然后传入分配好的retro_game_info结构体调用该函数，Swift代码如下：

import UIKit

class ViewController: UIViewController {
    var core: UnsafeMutableRawPointer?

    override func viewDidLoad() {
        super.viewDidLoad()
        setupEmulator()
    }

    func setupEmulator() {
        let corePath = Bundle.main.bundlePath + "/Frameworks/vice_x64sc_libretro_ios.dylib"

        if FileManager.default.fileExists(atPath: corePath) {
            core = dlopen(corePath, RTLD_LAZY)
            if core == nil {
                return
            }

            if let filePath = Bundle.main.path(forResource: "SomePrg", ofType: "prg") {
                loadGame(filePath)
            }
        }
    }

    func loadGame(_ filePath: String) {
        guard let core = self.core else {
            return
        }

        if let retroLoadGamePtr = dlsym(core, "retro_load_game") {
            typealias RetroLoadGameFunc = @convention(c) (UnsafeRawPointer?) -> Int32
            let retroLoadGame = unsafeBitCast(retroLoadGamePtr, to: RetroLoadGameFunc.self)

            if let fileData = try? Data(contentsOf: URL(fileURLWithPath: filePath)) {
                let pathCString = strdup(filePath)
                let dataPointer = malloc(fileData.count)

                if let pathCString = pathCString, let dataPointer = dataPointer {
                    fileData.copyBytes(to: dataPointer.assumingMemoryBound(to: UInt8.self), count: fileData.count)

                    var gameInfo = retro_game_info(
                        path: pathCString,
                        data: dataPointer,
                        size: fileData.count,
                        meta: nil
                    )

                    let result = retroLoadGame(UnsafeRawPointer(&gameInfo))  //  Crashes here

                    free(pathCString)
                    free(dataPointer)
                }
            }
        }
    }
}

struct retro_game_info {
    let path: UnsafePointer<CChar>?
    let data: UnsafeRawPointer?
    let size: size_t
    let meta: UnsafePointer<CChar>?
}

崩溃发生在：

let result = retroLoadGame(UnsafeRawPointer(&gameInfo))

已排查内容 #

• dlopen()成功加载.dylib
• dlsym()成功找到retro_load_game
• gameInfo.path和gameInfo.data在调用前已分配
• 调用后已释放分配的内存

疑问点 #

1. 我的Swift版retro_game_info结构体是否与C结构体匹配？
2. UnsafeRawPointer(&gameInfo)是否是向retro_load_game传递结构体的正确方式？
3. 是否存在可能导致EXC_BAD_ACCESS的内存对齐问题？
4. 有没有更好的调试方法来定位retro_load_game的失败原因？

1. Swift结构体与C结构体的匹配问题 #

你的Swift版retro_game_info结构体不完全匹配C端定义，存在两个关键问题：

• 类型映射错误：C的size_t在Swift中应使用CSize（系统提供的准确映射类型），而非直接用size_t别名，避免因平台位数差异导致的类型长度不匹配。
• 内存布局未强制对齐：Swift默认的结构体布局不一定和C完全一致，需要显式指定C兼容的布局规则。

修改后的Swift结构体（Swift 5.9+）：

@CStruct
struct retro_game_info {
    let path: UnsafePointer<CChar>?
    let data: UnsafeRawPointer?
    let size: CSize
    let meta: UnsafePointer<CChar>?
}

若使用低版本Swift，可替换为：

@_layout(standard: C)
struct retro_game_info {
    let path: UnsafePointer<CChar>?
    let data: UnsafeRawPointer?
    let size: CSize
    let meta: UnsafePointer<CChar>?
}

2. 结构体指针传递的正确性 #

UnsafeRawPointer(&gameInfo)的写法存在两个问题：

• 类型转换错误：C函数期望的是const struct retro_game_info *，应直接转换为UnsafePointer<retro_game_info>?，而非UnsafeRawPointer。
• 函数类型别名错误：C的bool在Swift中对应Bool，而非Int32，错误的返回值类型会破坏栈帧布局，引发崩溃。

修正后的代码片段：

// 修正函数类型别名
typealias RetroLoadGameFunc = @convention(c) (UnsafePointer<retro_game_info>?) -> Bool
let retroLoadGame = unsafeBitCast(retroLoadGamePtr, to: RetroLoadGameFunc.self)

// 修正指针传递方式
let result = retroLoadGame(UnsafePointer(&gameInfo))

另外，libretro核心的规则是：要么用路径模式（path非空，data设为nil、size设为0），要么用内存模式（data和size非空，path设为nil），同时设置两者会导致核心内部逻辑混乱，这很可能是你崩溃的直接原因。

3. 内存对齐问题 #

如果Swift结构体未强制使用C标准布局，成员的内存对齐方式会和C端不一致，导致C函数读取错误的内存地址，触发EXC_BAD_ACCESS。通过添加@CStruct或@_layout(standard: C)属性，可强制Swift使用C兼容的内存布局，彻底解决对齐问题。

4. 调试方法 #

• LLDB断点调试：在崩溃行设置断点，用po gameInfo查看结构体成员的地址和有效性；用bt命令打印调用栈，定位核心内部的崩溃位置。
• 启用Address Sanitizer：在Xcode的Scheme设置中开启Address Sanitizer（Run → Diagnostics → Enable Address Sanitizer），它能自动检测内存越界、野指针等问题，并给出详细的错误溯源。
• 捕获核心日志：先调用retro_set_log_callback设置日志回调函数，捕获libretro核心内部的错误输出，直接定位逻辑问题。
• 简化测试用例：先尝试纯路径模式（data设为nil、size设为0）调用函数，排除内存模式的干扰；使用已知可正常运行的ROM文件测试，排除游戏文件本身的问题。

内容的提问来源于stack exchange，提问作者Kristoffer Jälén