Crontab 执行 Shell 脚本报“找不到命令”通常是因 cron 环境不加载用户配置文件导致 PATH 变量缺失，最稳妥的解决办法是在脚本中使用命令绝对路径，或在 crontab 头部显式声明 PATH 变量。

核心原因分析

Cron 守护进程在启动任务时，不会加载用户登录时的 Shell 配置文件（如 ~/.bashrc、/etc/profile），因此交互式 Shell 中可用的环境变量（尤其是 PATH）在 cron 中往往不存在或极简。当脚本调用未指定绝对路径的命令（如 python3、mysqldump）时，系统因无法在默认路径中找到该命令而报错。

此外，cron 执行时的当前工作目录通常为用户家目录或根目录，而非脚本所在目录，若脚本内使用相对路径读取文件，也会因路径失效而间接导致执行异常。

分步排查与修复

按以下顺序排查，通常能解决大部分执行失败问题：

1. 查看错误日志
默认 cron 不会将错误打印到屏幕，需先确认报错内容。在 crontab 任务末尾添加输出重定向，日志建议存放在用户家目录下以避免权限或清理问题：

* * * * * /path/to/script.sh >> $HOME/cron_debug.log 2>&1

执行后检查 $HOME/cron_debug.log，若看到 command not found 则确认为环境变量问题。

2. 修正命令路径
将脚本中所有外部命令改为绝对路径。例如将 python3 script.py 改为 /usr/bin/python3 script.py。也可在脚本开头显式导出 PATH：

#!/bin/bash
export PATH=/usr/local/bin:/usr/bin:/bin:$PATH

3. 检查执行权限与解释器
确保脚本有执行权限（chmod +x script.sh），且第一行 Shebang 正确（如 #!/bin/bash）。若脚本从 Windows 编辑过，需去除 DOS 换行符（dos2unix script.sh），否则解释器路径会带隐藏字符导致执行失败。

4. 处理工作目录
若脚本依赖相对路径读取文件，需在脚本开头或 crontab 中切换目录：

* * * * * cd /path/to/workdir && ./script.sh >> log.txt 2>&1

完整脚本示例

以下是一个整合了环境变量设置、错误处理、日志记录的健壮脚本模板，可直接参考修改：

#!/bin/bash

# 1. 基础设置
set -e  # 遇到错误立即退出
set -u  # 使用未定义变量时报错

# 2. 显式定义 PATH，避免找不到命令
export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

# 3. 定义日志文件（使用家目录，避免权限问题）
LOG_FILE="$HOME/cron_job.log"

# 4. 重定向所有输出到日志
exec >> "$LOG_FILE" 2>&1

# 5. 打印开始时间
echo "[$(date '+%F %T')] Job Start"

# 6. 业务逻辑示例（务必使用绝对路径）
if /usr/bin/python3 /home/user/backup.py; then
    echo "[$(date '+%F %T')] Job Success"
else
    echo "[$(date '+%F %T')] Job Failed"
    # 可在此处添加报警逻辑
fi

# 7. 打印结束时间
echo "[$(date '+%F %T')] Job End"

权限与安全最佳实践

在配置定时任务时，需遵循权限最小化原则，避免安全隐患：

• 谨慎使用 sudo：尽量避免在 crontab 中直接使用 sudo。如果脚本确实需要 root 权限，建议直接将任务配置到 root 用户的 crontab 中（sudo crontab -e），而不是在普通用户任务中提权。
• 特定命令提权：若必须使用普通用户运行但部分命令需提权，请配置 /etc/sudoers 允许特定命令免密执行，而非赋予全部权限。
• 文件权限控制：脚本文件权限建议设置为 700 或 750，避免其他用户篡改。日志文件权限建议 600，防止敏感信息泄露。
• 用户一致性：确认编辑 crontab 的用户与脚本运行所需权限一致，普通用户无法操作系统级资源。

常见坑

• 特殊字符转义：crontab 中 % 字符会被视为换行符，若命令中包含（如 git commit 信息），需写成 \%。
• 环境变量隔离：不要在 crontab 中依赖 source /etc/profile 作为唯一解决方案，不同发行版加载机制可能不同，绝对路径更可靠。
• 中文标点与隐藏字符：从网页复制 cron 表达式时，容易带入不可见字符或中文标点，建议手动输入或使用 crontab -e 直接编辑。
• 日志清理：务必定期清理日志文件（如在脚本中加入日志轮转逻辑），避免日志占满磁盘空间。