为何NSMutableDictionary的setValue(_:forKey:)方法会崩溃？

安全阿岳

2026-5-28

嘿，我来帮你逐一捋清楚这些问题——这些都是用NSMutableDictionary时很容易踩的坑，我自己做iOS/macOS开发时也碰到过好几次类似的情况：

1. 主线程写但频繁访问会导致崩溃吗？

肯定会！NSMutableDictionary完全不是线程安全的——哪怕你只在主线程做写入操作，如果有其他线程在并发读取这个字典，就会直接破坏它内部的哈希表结构，进而触发EXC_BAD_ACCESS、内存错误这类崩溃。

你提到“仅在主线程写入，但它被频繁访问”，这里的“访问”如果包含了非主线程的读操作，那就是问题的核心。哪怕所有操作都在主线程，极端密集的循环读写（比如短时间内几千次调用setValue:forKey:）也可能因为RunLoop的调度意外导致内部结构混乱，但这种情况很少见，绝大多数崩溃还是跨线程的数据竞争导致的。

2. 不用Core Data，怎么让NSMutableDictionary访问更可靠？

既然已经确定用字典做持久化，核心思路就是把所有字典的读写操作都变成线程安全的，给你几个实用的方案：

方案一：用串行队列做串行化访问

创建一个专用的串行队列，所有对字典的操作都通过这个队列执行，相当于把并发操作变成串行，从根源避免竞争：

// 定义属性
@property (nonatomic, strong) dispatch_queue_t dictSafeQueue;
@property (nonatomic, strong) NSMutableDictionary *persistDict;

// 初始化
- (void)setupSafeDict {
    self.dictSafeQueue = dispatch_queue_create("com.yourapp.safe.dict.queue", DISPATCH_QUEUE_SERIAL);
    self.persistDict = [NSMutableDictionary dictionaryWithContentsOfFile:self.persistFilePath];
}

// 安全写操作（带持久化）
- (void)safeSetValue:(id)value forKey:(NSString *)key {
    dispatch_barrier_async(self.dictSafeQueue, ^{
        [self.persistDict setValue:value forKey:key];
        // 同步到文件做持久化
        [self.persistDict writeToFile:self.persistFilePath atomically:YES];
    });
}

// 安全读操作
- (id)safeValueForKey:(NSString *)key {
    __block id result;
    dispatch_sync(self.dictSafeQueue, ^{
        result = [self.persistDict valueForKey:key];
    });
    return result;
}

如果想优化读性能，可以把队列改成并发队列，写操作用dispatch_barrier_async保证独占，读操作用dispatch_sync并发执行，兼顾安全和效率。

方案二：用锁保护访问

最简单的是用@synchronized块，代码量少易上手，只是性能比队列稍差：

- (void)safeSetValue:(id)value forKey:(NSString *)key {
    @synchronized(self.persistDict) {
        [self.persistDict setValue:value forKey:key];
        [self.persistDict writeToFile:self.persistFilePath atomically:YES];
    }
}

- (id)safeValueForKey:(NSString *)key {
    @synchronized(self.persistDict) {
        return [self.persistDict valueForKey:key];
    }
}

如果追求更高性能，可以用os_unfair_lock（iOS 10+/macOS 10.12+），它比NSLock和@synchronized的开销更小。

方案三：封装线程安全字典类

把所有字典操作都封装到一个自定义类里，内部处理线程安全逻辑，对外只暴露安全的API，业务代码不用关心锁或队列的细节，维护起来更省心。

3. 循环中setValue崩溃，怎么定位具体哪次调用？

你遇到的“打印keyPath后循环才崩溃”，说明崩溃不是在setValue瞬间发生的，而是之前的操作已经破坏了字典内部结构，后续访问时才触发崩溃。给你几个高效的定位方法：

用Thread Sanitizer检测竞争：这是最直接的方法！在Xcode中打开Product > Scheme > Edit Scheme，在Run > Diagnostics里勾选Thread Sanitizer，然后运行APP。TSAN会自动检测出跨线程的数据竞争位置，直接告诉你哪行代码在不安全地访问字典。
加详细操作日志：不仅打印key，还要记录当前线程、操作类型（读/写）以及字典的实时状态：

for (NSString *key in yourKeyList) {
    NSLog(@"[WRITE] Thread: %@, Key: %@, Dict Count: %lu", [NSThread currentThread], key, (unsigned long)self.persistDict.count);
    [self.persistDict setValue:yourValue forKey:key];
}

崩溃前的最后几条日志，大概率能帮你锁定出问题的key。

设置符号断点：在Xcode的Breakpoint Navigator里，点击+ > Symbolic Breakpoint，输入-[NSMutableDictionary setValue:forKey:]，勾选Automatically continue after evaluating actions，然后添加一个Log Message动作，输入Set value for key: @(arg2)（arg2是方法的第二个参数，也就是key）。这样每次调用都会自动打印key，崩溃时就能看到最后一次成功打印的key，缩小排查范围。
加入断言检查：在循环里每次setValue后，立刻检查字典是否能正常访问：

for (NSString *key in yourKeyList) {
    [self.persistDict setValue:yourValue forKey:key];
    NSAssert([self.persistDict valueForKey:key] != nil, @"Failed to set value for key: %@", key);
}

如果某次操作已经损坏了字典，断言会直接触发，精准定位到出问题的那一次调用。

内容的提问来源于stack exchange，提问作者János

为何NSMutableDictionary的setValue(_:forKey:)方法会崩溃？

1. 主线程写但频繁访问会导致崩溃吗？ #

2. 不用Core Data，怎么让NSMutableDictionary访问更可靠？ #

方案一：用串行队列做串行化访问 #

方案二：用锁保护访问 #

方案三：封装线程安全字典类 #