Mac登录/退出脚本配置无效问题排查及优化方案咨询

问题排查 #

以下是导致脚本无法正常运行的核心原因：

• 脚本参数逻辑错误：原脚本将登录动作参数（login）直接当作用户名写入日志，而非接收实际用户名；同时参数判断逻辑模糊，无法正确区分动作与用户信息。
• LaunchAgent不解析Shell变量：登录plist中的$(whoami)会被当作字面量字符串传递，无法解析为当前用户名。
• LogoutAgent硬编码用户名：退出plist中的username为固定字符串，无法匹配实际登录用户。
• 可能的权限/路径问题：需确认脚本已设置可执行权限（chmod +x /Users/kamabokogonpachiro/Desktop/logfile.sh），且日志文件所在目录（桌面）有写入权限。
• Launchd加载状态异常：可通过launchctl list | grep com.user查看服务是否加载成功；若加载失败，可通过log show --predicate 'process == "launchd"' --info查看具体错误日志。

修复后的配置与脚本 #

修正后的Shell脚本 #

#!/bin/bash

# 日志文件路径（建议放在用户日志目录，而非桌面）
LOG_FILE="$HOME/Library/Logs/user_session.log"
# 获取当前用户名
USER_NAME=$(whoami)

# 登录日志函数
log_login() {
    # 使用date格式化输出，便于日志分析
    echo "$(date '+%Y-%m-%d %H:%M:%S') - User $USER_NAME logged in" >> "$LOG_FILE"
}

# 退出日志函数
log_logout() {
    echo "$(date '+%Y-%m-%d %H:%M:%S') - User $USER_NAME logged out" >> "$LOG_FILE"
}

# 动作判断逻辑
case "$1" in
    login)
        log_login
        ;;
    logout)
        log_logout
        ;;
    *)
        echo "错误参数：$1，请使用 'login' 或 'logout'。" >&2
        exit 1
        ;;
esac

登录配置plist（~/Library/LaunchAgents/com.user.login.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.login</string>
    <key>ProgramArguments</key>
    <array>
        <string>/Users/kamabokogonpachiro/Desktop/logfile.sh</string>
        <string>login</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>WorkingDirectory</key>
    <string>/Users/kamabokogonpachiro</string>
</dict>
</plist>

退出配置plist（~/Library/LogoutAgents/com.user.logout.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.logout</string>
    <key>ProgramArguments</key>
    <array>
        <string>/Users/kamabokogonpachiro/Desktop/logfile.sh</string>
        <string>logout</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>

修复后的操作步骤 #

1. 更新脚本与plist文件内容。
2. 重新设置权限：

   chmod +x /Users/kamabokogonpachiro/Desktop/logfile.sh
   chmod 644 ~/Library/LaunchAgents/com.user.login.plist
   chmod 644 ~/Library/LogoutAgents/com.user.logout.plist
   

3. 重新加载服务：

   launchctl unload ~/Library/LaunchAgents/com.user.login.plist
   launchctl load ~/Library/LaunchAgents/com.user.login.plist
   launchctl unload ~/Library/LogoutAgents/com.user.logout.plist
   launchctl load ~/Library/LogoutAgents/com.user.logout.plist
   

4. 手动测试：运行/Users/kamabokogonpachiro/Desktop/logfile.sh login，查看日志文件是否生成正确记录。

更优实现方案 #

1. 整合系统日志框架 #

使用logger命令将日志写入系统日志，便于统一管理与查询：

log_login() {
    logger -t user-session-log "User $USER_NAME logged in"
}

log_logout() {
    logger -t user-session-log "User $USER_NAME logged out"
}

查询日志命令：log show --predicate 'sender == "user-session-log"' --info

2. 日志轮转 #

避免日志文件无限增大，可添加日志大小检查逻辑：

# 限制日志文件大小为10MB，超过则备份
MAX_LOG_SIZE=$((10 * 1024 * 1024))
if [ -f "$LOG_FILE" ] && [ $(stat -f%z "$LOG_FILE") -gt $MAX_LOG_SIZE ]; then
    mv "$LOG_FILE" "$LOG_FILE.old"
fi

3. 避免硬编码路径 #

使用环境变量替代固定路径，提升脚本可移植性：

LOG_FILE="${HOME}/Library/Logs/user_session.log"
SCRIPT_PATH="${HOME}/Desktop/logfile.sh"

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