macOS Objective-C项目Storyboard化后NSDocument新建标签页WKWebView异常

这种情况我之前在Objective-C的macOS项目切换到Storyboard时也踩过类似的坑，大概率是新创建的NSDocument实例没有正确加载目标URL，而是复用了当前实例的状态，下面给你几个排查和解决的方向：

1. 检查NSDocument的URL加载逻辑 #

NSDocument在新建标签页时会生成一个全新的实例，你需要确保这个新实例能拿到要打开的目标URL，而不是默认复用当前内容：

首先，在你的NSDocument子类里重写readFromURL:ofType:error:方法，保存当前document对应的URL：

// 你的Document.h
@property (nonatomic, strong) NSURL *targetURL;

// Document.m
- (BOOL)readFromURL:(NSURL *)url ofType:(NSString *)typeName error:(NSError **)outError {
    if (![super readFromURL:url ofType:typeName error:outError]) {
        return NO;
    }
    // 保存要加载的目标URL
    self.targetURL = url;
    return YES;
}

然后在窗口加载完成后，让WKWebView加载这个URL。如果用Storyboard，可以在windowControllerDidLoadNib:里处理：

- (void)windowControllerDidLoadNib:(NSWindowController *)windowController {
    [super windowControllerDidLoadNib:windowController];
    // 确保IBOutlet已经正确连接到Storyboard中的WKWebView
    if (self.webView && self.targetURL) {
        NSURLRequest *request = [NSURLRequest requestWithURL:self.targetURL];
        [self.webView loadRequest:request];
    }
}

2. 确认每个标签页有独立的WKWebView #

很容易犯的错误是共用WKWebView实例，比如把webView声明成全局变量，或者Storyboard配置导致多个document复用同一个webView：

• 检查IBOutlet连接：确保Storyboard中的WKWebView属于Window Controller的子视图，每个新的Window Controller实例都会创建新的webView。
• 检查makeWindowControllers方法：确保每次新建document都会实例化新的Window Controller，而非复用缓存实例：

- (void)makeWindowControllers {
    NSStoryboard *mainStoryboard = [NSStoryboard storyboardWithName:@"Main" bundle:nil];
    NSWindowController *windowController = [mainStoryboard instantiateControllerWithIdentifier:@"YourWindowControllerID"];
    [self addWindowController:windowController];
}

3. 排查自定义的标签页创建逻辑 #

如果你自定义了新建标签页的逻辑（比如重写newDocumentForTab:或自定义菜单响应），要确保传递了正确的目标URL给新document实例：

- (NSDocument *)newDocumentForTab:(NSWindow *)window {
    YourDocument *newDoc = [[YourDocument alloc] init];
    // 根据需求传递目标URL，比如从选中文件或菜单参数中获取
    if (self.targetURL) {
        [newDoc readFromURL:self.targetURL ofType:@"public.html" error:nil];
    }
    return newDoc;
}

4. 检查全局状态或缓存 #

如果你的app里有全局URL变量、共享的webView缓存，新document创建时没有重置这些状态，就会导致加载当前内容。检查代码中有没有类似static NSURL *sharedURL的全局变量，确保新document实例不会读取这些共享状态。

最后，你可以在readFromURL:和windowControllerDidLoadNib:里加NSLog打印URL，确认新document实例拿到的是不是目标URL，这样能快速定位问题所在。

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