LaunchD触发生成两个LaunchAgent实例的问题排查咨询

问题根源 #

你的Server部署在/System/Library/LaunchDaemons下，以root权限运行；当它向QueueDirectories路径写入文件时，launchd会以触发进程的身份（root）启动/System/Library/LaunchAgents下的Agent。而用户登录后，用户会话的launchd又会以当前用户身份再次启动Agent，最终导致两个不同权限的实例共存。

解决方案 #

1. 明确指定Agent的运行用户

在Agent的plist配置中添加UserName字段，强制指定为当前会话用户，这样root进程触发时会因为身份不匹配而跳过启动，仅用户会话的launchd会加载Agent。

示例plist配置：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.yourcompany.agent</string>
    <key>ProgramArguments</key>
    <array>
        <string>/path/to/your/Agent</string>
    </array>
    <!-- 指定为当前会话用户，% 是占位符表示当前登录用户 -->
    <key>UserName</key>
    <string>%</string>
    <!-- 配置KeepAlive逻辑：崩溃时重启，用户退出Manager则停止 -->
    <key>KeepAlive</key>
    <dict>
        <key>SuccessfulExit</key>
        <false/> <!-- 非0退出码时重启（崩溃场景） -->
        <key>OtherJobEnabled</key>
        <string>com.yourcompany.manager</string> <!-- Manager运行时才保持存活 -->
    </dict>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>

2. 拆分触发逻辑，避免跨权限触发

将Server和Agent的通信改为XPC直接交互，去掉QueueDirectories的依赖：

• Server启动后，主动通过XPC查找用户会话中的Agent实例；如果不存在，通过launchd的API（SMJobSubmit）以用户身份启动Agent。
• Agent启动后负责启动Manager，并保持和Server的XPC连接。

这种方式能确保Agent始终以用户权限启动，不会被root进程触发。

3. 给Agent添加单实例校验

在Agent代码中添加排他锁逻辑，启动时检测是否已有实例存在，若有则直接退出。

示例Objective-C代码：

- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
    NSString *lockDir = [NSHomeDirectory() stringByAppendingPathComponent:@"Library/Application Support/YourApp"];
    NSFileManager *fm = [NSFileManager defaultManager];
    if (![fm fileExistsAtPath:lockDir]) {
        [fm createDirectoryAtPath:lockDir withIntermediateDirectories:YES attributes:nil error:nil];
    }
    NSString *lockPath = [lockDir stringByAppendingPathComponent:@"agent.lock"];
    
    // 创建并加排他锁
    int fd = open([lockPath UTF8String], O_WRONLY | O_CREAT, 0644);
    if (fd == -1 || flock(fd, LOCK_EX | LOCK_NB) == -1) {
        // 无法获取锁，说明已有实例，退出
        exit(0);
    }
    // 锁会在进程退出时自动释放
}

验证步骤 #

1. 重启系统，执行ps aux | grep Agent，确认只有一个用户权限的Agent进程。
2. 手动退出Manager，检查Agent是否随之退出；强制杀死Agent，确认它会自动重启。
3. 测试Server功能，确认能正常和Agent通信，无权限问题。

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