macOS Swift Helper App自动启动时无法正常工作的问题排查

问题1：系统自动启动时无法发送请求 #

原因 #

• 系统登录初期网络可能未完全初始化，此时NWPathMonitor检测到的satisfied状态可能不稳定，且Helper App启动时可能还未获取到网络访问权限（沙箱环境下更明显）。
• URLSessionDataTask是一次性对象，调用resume()后任务进入完成状态，无法重复使用。

修复动作 #

1. 配置网络权限：在Info.plist中添加NSAppTransportSecurity配置（若目标为HTTP站点），同时确保沙箱权限中Outgoing Connections (Client)已开启。
2. 延迟启动监听：给系统留足网络初始化时间，避免启动瞬间就发起请求。
3. 每次触发时重建请求任务：不再复用同一个任务对象，每次网络连接成功时重新生成请求和任务。

问题2：网络连接状态变更仅触发一次请求 #

原因 #

你创建的task对象只能执行一次，调用resume()后任务完成，后续调用不会生效。必须在每次网络连接成功时重新构建请求任务。

完整修改代码 #

import Cocoa
import Network

@main
class AppDelegate: NSObject, NSApplicationDelegate {
    let defaults = UserDefaults.init(suiteName: "replaced userdefaults group name thing")
    var monitor: NWPathMonitor?
    let monitorQueue = DispatchQueue(label: "NetworkMonitorQueue")

    func applicationDidFinishLaunching(_ aNotification: Notification) {
        // 延迟1秒启动网络监听，等待系统网络初始化完成
        DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
            self.setupNetworkMonitor()
        }
    }

    private func setupNetworkMonitor() {
        monitor = NWPathMonitor()
        monitor?.pathUpdateHandler = { [weak self] path in
            guard let self = self else { return }
            if path.status == .satisfied {
                self.sendLoginRequest()
            }
        }
        monitor?.start(queue: monitorQueue)
    }

    private func sendLoginRequest() {
        // 安全获取登录凭据，避免强制解包崩溃
        guard let defaults = defaults,
              let username = defaults.string(forKey: "username"),
              let passwordData = kread(service: "detnsw-autologin", account: username),
              let password = String(data: passwordData, encoding: .utf8) else {
            print("[错误] 无法获取有效登录凭据")
            return
        }

        guard let requestUrl = URL(string: "the login page url") else {
            print("[错误] 登录URL无效")
            return
        }

        var request = URLRequest(url: requestUrl)
        request.httpMethod = "POST"
        
        // 对用户名密码做URL编码，避免特殊字符破坏请求格式
        let encodedUsername = username.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) ?? username
        let encodedPassword = password.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) ?? password
        let postString = "csrfmiddlewaretoken=&username=\(encodedUsername)&password=\(encodedPassword)"
        request.httpBody = postString.data(using: .utf8)

        // 添加浏览器模拟请求头，适配校园网接口验证逻辑
        request.setValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")
        request.setValue("Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36", forHTTPHeaderField: "User-Agent")

        let task = URLSession.shared.dataTask(with: request) { data, response, error in
            if let error = error {
                print("[登录失败] 请求错误：\(error.localizedDescription)")
                return
            }

            if let httpResponse = response as? HTTPURLResponse {
                print("[请求状态] 响应码：\(httpResponse.statusCode)")
                // 根据校园网登录接口的实际响应判断结果，比如302跳转或200成功
                if httpResponse.statusCode == 302 || httpResponse.statusCode == 200 {
                    print("[登录成功]")
                } else {
                    print("[登录失败] 状态码异常")
                }
            }
        }
        task.resume()
    }

    func applicationWillTerminate(_ aNotification: Notification) {
        monitor?.cancel()
    }

    func applicationSupportsSecureRestorableState(_ app: NSApplication) -> Bool {
        return true
    }
}

额外优化提示 #

• URL编码：必须对用户名、密码做URL编码，避免特殊字符（如@、&、空格）导致请求参数解析失败。
• 请求头适配：多数校园网登录接口会验证请求来源，模拟浏览器的User-Agent可提升成功率。
• 错误日志：添加详细的错误打印，方便调试启动时的权限、凭据获取问题。

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