Crontab无法执行Shell脚本求助：手动可运行但定时任务仅首个生效

这种问题我碰到过好多次，大概率是crontab的运行环境和你手动登录时的环境不一样导致的，咱们一步步来排查解决：

第一步：先排查错误日志 #

crontab默认会把任务的输出（包括错误信息）发送到你的系统邮箱，但很多人没配置邮箱收信，所以最好把日志重定向到文件，方便排查。修改crontab里的第二个任务：

48 08 * * * /Users/joaopimenta/Documents/joaopython/scripts/automatecsv.sh >> /tmp/automatecsv.log 2>&1

等任务执行后，查看/tmp/automatecsv.log就能知道具体哪里出错了（比如找不到命令、路径不存在之类的）。

第二步：修改你的Shell脚本 #

你的第二个脚本在手动执行时正常，但crontab里失败，主要有几个常见坑，我们逐个修复：

1. 指定脚本的Shell环境 #

crontab默认用sh作为执行shell，而source是bash的专属命令，sh里不支持（sh里要用.代替）。所以在脚本第一行加上bash的声明：

#!/bin/bash

2. 避免目录切换失败的隐患 #

cd命令如果失败（比如路径写错、权限问题），后面的命令会在错误的目录执行，导致报错。所以要给cd命令加上失败检查：

cd /Users/joaopimenta/Documents/joaopython || { echo "无法切换到目标目录" >> /tmp/automatecsv.err; exit 1; }

这样如果cd失败，脚本会直接退出并记录错误。

3. 用绝对路径调用虚拟环境的Python #

手动执行时你的环境变量里有虚拟环境的路径，但crontab的PATH非常精简，即使source了虚拟环境，也可能找不到python命令。最可靠的方式是直接用虚拟环境Python的绝对路径，不需要source：

/Users/joaopimenta/Documents/joaopython/env/bin/python /Users/joaopimenta/Documents/joaopython/ProdSqlToCsvHeaders.py

修改后的完整脚本 #

#!/bin/bash

# 切换到目标目录，失败则退出并记录错误
cd /Users/joaopimenta/Documents/joaopython || { echo "Failed to change to target directory" >> /tmp/automatecsv.err; exit 1; }

# 直接使用虚拟环境的Python执行脚本
/Users/joaopimenta/Documents/joaopython/env/bin/python /Users/joaopimenta/Documents/joaopython/ProdSqlToCsvHeaders.py

为什么这样修改？ #

• crontab的运行环境没有你登录时的环境变量（比如PATH、虚拟环境的激活状态），所以所有命令尽量用绝对路径，避免依赖环境变量。
• 指定bash shell能确保脚本里的bash特性正常工作（不过这里我们用绝对路径Python就不需要source了）。
• 给cd命令加失败检查能快速定位目录相关的问题，避免后续命令无意义的执行。

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