launchd运行shell脚本无法识别$USER环境变量问题求助

• launchd 执行任务时默认提供的环境变量非常少，不会自动继承登录用户的$USER、$HOME这类用户专属环境变量
• 如果你当前的 plist 配置放在 /Library/LaunchAgents 目录下，属于全局用户级启动项，加载时机可能早于用户会话完全初始化的时间点，进一步导致用户变量未被赋值

1. 修改shell脚本，不再依赖环境变量$USER #

推荐用logname命令获取当前登录的用户身份，这个命令在launchd运行环境下比whoami更稳定，修改后的完整脚本如下：

#!/bin/sh
# 显式获取当前登录用户
USER=$(logname)
SharePath=$(dscl /Search -read /Users/$USER OriginalHomeDirectory | awk '{ print $2 }' | sed -e 's/<[^>]*>//g'| awk -F'/' '{ print substr($0, index($0, $4))}')

prefix='/Volumes/'

LocalMountPoint=$prefix$SharePath
# 增加路径存在判断，避免无效报错
if [ -d "$LocalMountPoint" ]; then
    # 先删除已存在的同名软链接，避免重复创建报错
    rm -f "/Users/$USER/Desktop/P Drive"
    ln -s "$LocalMountPoint" "/Users/$USER/Desktop/P Drive"
fi

给脚本添加执行权限：
chmod +x /Library/pdrive.sh

2. 优化LaunchAgent plist配置 #

建议将plist放到当前用户的专属LaunchAgent目录~/Library/LaunchAgents/下，仅在当前用户登录后加载，避免全局启动项的时机问题，优化后的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.user.loginscript2</string>
        <key>ProgramArguments</key>
        <array>
            <string>/Library/pdrive.sh</string>
        </array>
        <key>RunAtLoad</key>
        <true/>
        <!-- 仅在GUI用户会话登录后运行，避免加载过早 -->
        <key>LimitLoadToSessionType</key>
        <string>Aqua</string>
        <key>StandardErrorPath</key>
        <string>/tmp/com.user.loginscript2.err</string>
        <key>StandardOutPath</key>
        <string>/tmp/com.user.loginscript2.out</string>
</dict>
</plist>

注意：原plist的ProgramArguments应该用数组包裹，部分macOS版本直接写string会导致执行失败

3. 重新加载启动项生效 #

先卸载旧的启动项，再加载新配置：

# 全局配置执行以下命令
sudo launchctl unload /Library/LaunchAgents/com.user.loginscript2.plist
sudo launchctl load /Library/LaunchAgents/com.user.loginscript2.plist

# 放到用户目录的配置执行以下命令
launchctl unload ~/Library/LaunchAgents/com.user.loginscript2.plist
launchctl load ~/Library/LaunchAgents/com.user.loginscript2.plist

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