macOS 上 AccessClient 无法唤起？排查 Python 架构与 Windows App 识别问题

在 Apple Silicon Mac 上排查 AccessClient 时，遇到了两类表面上不同的故障：网页点击"访问"后客户端没有启动；访问 Windows 资产时，AccessClient 提示没有安装 Microsoft Remote Desktop，但电脑上已经安装了 Windows App。

这次排查最终定位到两个兼容性问题：启动脚本依赖了当前 macOS 环境中不可用的 python 命令，且启动进程与 Python 组件的 CPU 架构不一致；Windows 客户端检测逻辑则只检查旧版 Microsoft Remote Desktop，没有识别 Windows App。本文整理了改前与改后的关键代码、处理思路和验证范围。

说明：示例已删除服务器地址、账号、SSH 配置和真实连接参数。文中的 Python 路径来自当时的本机配置，迁移到其他电脑前需要按实际安装位置调整。

问题现象与环境

• macOS 运行于 Apple Silicon 设备。
• 浏览器通过 accessclient:// 协议调用本机 AccessClient。
• Windows App 已安装，但 AccessClient 报告未检测到远程桌面客户端。
• 修改范围限于 AccessClient 的启动脚本 main.scpt 和加载器 loader.py。

一、网页点击"访问"后 AccessClient 没有启动

改前：调用未指定路径的 python

原启动脚本直接拼接 shell 命令，并使用 python 作为解释器：

on open location this_url
    set exec_path to POSIX path of (path to me) & "Contents/Resources/Scripts/main.py"
    set resources_dir to POSIX path of (path to me) & "Contents/Resources"
    set logfile to (system attribute "TMPDIR") & "AccessClient.out"
    do shell script "python '" & exec_path & "' '" & this_url & "' '" & resources_dir & "' > " & logfile & " 2>&1 &"
end open location

应用从浏览器协议启动时使用的运行环境，不一定和终端里的环境变量相同。本机日志显示启动脚本找不到 python。此外，启动器按 Intel 架构运行，而可用 Python 及其组件是 Apple Silicon 架构，可能导致解释器或依赖加载失败。

原命令还通过字符串拼接传入脚本路径、协议 URL 和资源目录；如果参数带有空格或 shell 特殊字符，解析结果可能与预期不同。

改后：指定 Python 3 路径和 ARM64 架构

调整后明确指定 Python 3 的可执行文件，并使用 quoted form of 安全处理 shell 参数：

on open location this_url
    set exec_path to POSIX path of (path to me) & "Contents/Resources/Scripts/main.py"
    set resources_dir to POSIX path of (path to me) & "Contents/Resources"
    set logfile to (system attribute "TMPDIR") & "AccessClient.out"
    do shell script "/usr/bin/arch -arm64 /usr/local/bin/python3 " & quoted form of exec_path & " " & quoted form of this_url & " " & quoted form of resources_dir & " > " & quoted form of logfile & " 2>&1 &"
end open location

这里的 /usr/local/bin/python3 是本机当时使用的路径。部署到其他 Mac 时，应先确认 Python 3 的真实位置，并确认解释器架构与已安装依赖一致；不要直接照抄这个路径。显式使用 arch -arm64 可以让启动进程按 ARM64 架构运行，quoted form of 则避免参数中的空格和特殊字符破坏命令解析。

二、Windows App 已安装，却提示没有远程桌面客户端

改前：只检查旧版应用

原检测函数只检查 Microsoft Remote Desktop 正式版和 Beta 版：

def mrd_exist_in_applications():
    mrd_path = "/Applications/Microsoft Remote Desktop.app/Contents/MacOS/Microsoft Remote Desktop"
    mrd_beta_path = "/Applications/Microsoft Remote Desktop Beta.app/Contents/MacOS/Microsoft Remote Desktop Beta"
    return utils.exist_and_executable(mrd_path) or utils.exist_and_executable(mrd_beta_path)

当系统中只有 Windows App 时，这个函数仍会返回"客户端不存在"。另外，原来的加载器只把生成的 RDP 配置文件加入启动参数，没有明确指定由 Windows App 打开。

改后：识别 Windows App，并指定打开程序

先在可执行文件检测中增加 Windows App 的标准应用包路径：

def mrd_exist_in_applications():
    mrd_path = "/Applications/Microsoft Remote Desktop.app/Contents/MacOS/Microsoft Remote Desktop"
    mrd_beta_path = "/Applications/Microsoft Remote Desktop Beta.app/Contents/MacOS/Microsoft Remote Desktop Beta"
    windows_app_path = "/Applications/Windows App.app/Contents/MacOS/Windows App"
    return (utils.exist_and_executable(mrd_path)
            or utils.exist_and_executable(mrd_beta_path)
            or utils.exist_and_executable(windows_app_path))

然后在加载器生成启动参数时，如果 Windows App 的可执行文件存在，就通过 open -a 对应的参数指定应用，再传入 RDP 文件：

class MrdLoader(Loader):
    def get_cmdline_args(self):
        cmdline_args = []
        self.cfg_file = self.generate_mstsc_cfg()
        windows_app = "/Applications/Windows App.app"
        windows_app_executable = os.path.join(
            windows_app, "Contents", "MacOS", "Windows App")
        if utils.exist_and_executable(windows_app_executable):
            cmdline_args.extend(["-a", windows_app])
        cmdline_args.append(self.cfg_file)
        return cmdline_args

若本地 loader.py 尚未导入 os，需要补上对应导入。应用安装位置不同时，也应相应调整 Windows App 的路径。旧版 Microsoft Remote Desktop 的检测仍然保留，因此原有客户端不会因为这次修改而失去兼容。

三、验证结果与边界

本次排查完成了以下本地验证：

1. 启动脚本使用指定的 Python 3 路径和 ARM64 架构；调整后，浏览器协议唤起及 SSH 启动由用户确认恢复正常。
2. Windows App 的可执行文件检查能够识别已安装客户端。
3. 加载器生成的参数包含 Windows App 应用路径和临时 RDP 配置文件。

远程桌面会话本身尚未完成端到端登录验证。因此，这次结果能确认客户端识别与启动参数已修正，但不能据此断言目标 Windows 服务器连接已全部验证通过。

排查时可以优先检查

• 从浏览器触发协议时，AccessClient 是否使用了与终端相同的 Python 环境。
• Python 3 可执行文件是否存在，CPU 架构是否与 Python 依赖匹配。
• shell 命令中的脚本路径、URL 和资源路径是否经过正确引用。
• 客户端检测逻辑是否覆盖实际安装的应用包和内部可执行文件。
• 生成的启动参数是否明确指定预期的应用，并传入有效的 RDP 配置文件。
• 区分"本机识别并启动客户端"和"远程服务器登录成功"这两类验证结果。

参考资料

• AccessClient 在 macOS 14 Sonoma 下无法调用远程桌面的排查文章
• Microsoft Learn：Windows App 入门与连接指南
• Microsoft Learn：macOS 版 Remote Desktop 客户端说明