MacOS 15.x下个人LaunchAgent失效：无法识别iCloud桌面文件？

问题描述 #

• 有一个使用10余年的LaunchAgent，功能为每周自动清理桌面，将所有文件移动至Desktop_Archive文件夹
• 脚本手动执行完全正常，但通过launchd运行时，始终无法识别桌面上的文件，输出"Nothing to do"
• 已通过脚本中加入who am i确认，launchd是以本人身份运行脚本
• 若将脚本的目标目录从~/Desktop改为自定义的Dummy目录，通过launchd运行则能正常归档文件

命令与执行结果对比 #

1. 通过launchd启动桌面归档脚本 #

$ launchctl kickstart gui/501/com.pdc.archive_desktop

执行结果：

pdc                  Apr  8 19:25
Nothing to do
SUCCESS

2. 手动执行桌面归档脚本 #

$ /Users/pdc/bin/archive_desktop

执行结果：

pdc     ttys001      Apr  8 19:06
.
.
.
(已归档的文件名)
.
.
.
Archived Desktop to /Users/pdc/Desktop_Archive/Archive_2025-04-08
SUCCESS

3. 通过launchd启动Dummy目录归档脚本 #

$ launchctl kickstart gui/501/com.pdc.archive_dummy

执行结果：

pdc                  Apr  8 19:32
.
.
.
(已归档的文件名)
.
.
.
Archived Dummy to /Users/michaelheinz/Desktop_Archive/Archive_2025-04-08
SUCCESS

排查与解决方向 #

• 检查隐私权限：macOS将~/Desktop列为隐私敏感目录，launchd进程可能未获得访问权限。前往「系统设置>隐私与安全性>文件和文件夹」，确认是否已授权脚本或相关进程访问桌面目录。
• 替换为绝对路径：脚本中若使用~/Desktop这类路径，launchd的环境变量可能与终端不同，导致路径解析异常。建议将脚本中的桌面路径替换为绝对路径/Users/pdc/Desktop。
• 设置工作目录：如果LaunchAgent的plist文件未指定WorkingDirectory，默认工作目录可能不是用户主目录，引发相对路径错误。可在plist中添加配置：

  <key>WorkingDirectory</key>
  <string>/Users/pdc</string>
  

• 适配沙盒机制：新版本macOS对launchd的沙盒限制更严格，即使以用户身份运行，也可能无法直接访问受保护目录。可尝试用AppleScript间接访问桌面文件，或调整LaunchAgent的权限配置。

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