Linux cron 使用相对路径失败时环境差异在哪里

Linux cron 中“脚本手工执行正常，定时执行却找不到文件”，最常见的原因不是文件消失，而是两次运行的环境不同。交互式 Shell 通常从项目目录启动，cron 则由后台守护进程创建任务；HOME、PATH 和当前工作目录也不是一回事。稳妥做法是：脚本入口、配置文件、日志使用绝对路径；确实依赖相对路径时，在脚本内显式切换到固定目录，并把环境记录下来。

相对路径是相对于进程的当前工作目录解析的，不是相对于 crontab 文件、脚本文件或 HOME 解析的。

为什么交互式Shell能跑，cron却找不到文件

Cronie 的 crontab(5) 说明了 cron 会为任务准备 SHELL、HOME、LOGNAME 等环境；PATH 还可能来自守护进程或配置。它说明的是变量来源，不等于给脚本定义了项目目录。你在终端执行 ./bin/report.sh 时，当前目录可能正好是项目根目录；cron 执行同一句命令时，./bin 的含义就可能完全不同。

先把相对路径依赖改成显式契约

最小修复是让 crontab 只负责按时调用一个绝对路径脚本。脚本再决定自己的工作目录、配置位置和日志位置。下面的写法不依赖任务从哪个目录启动：

#!/bin/sh
# 固定脚本目录，避免 cron 的当前工作目录影响相对引用
set -eu
BASE_DIR="/srv/report-job"
cd "$BASE_DIR"

# 配置、输出都显式写出，失败时让 cron 看到非零退出码
CONFIG="$BASE_DIR/config/report.conf"
LOG="$BASE_DIR/var/report.log"
/usr/local/bin/report-tool --config "$CONFIG" >>"$LOG" 2>&1

对应的 crontab 也使用绝对路径，并显式准备需要的命令搜索路径：

# 使用绝对解释器和脚本入口，避免交互式 PATH 造成差异
SHELL=/bin/sh
PATH=/usr/local/bin:/usr/bin:/bin
17 2 * * * /srv/report-job/bin/run-report.sh

如果脚本必须使用相对文件名，cd 应该靠近入口，并用引号包住可能含空格的路径。不要用 ~ 代替绝对路径，也不要把 HOME 拼接成所有文件的根目录；服务账号的主目录和登录账号可能不同。

用日志证明到底差在哪里

排查时先记录环境，再改业务命令。下面的诊断片段只输出必要信息，避免把完整环境变量写入公开日志：

#!/bin/sh
# 记录路径解析所需的最小环境，不泄露完整环境变量
set -u
LOG=/srv/report-job/var/cron-debug.log
{
  printf '%s\n' '--- cron context ---'
  printf 'user=%s\n' "$(id -un)"
  printf 'pwd=%s\n' "$PWD"
  printf 'home=%s\n' "\${HOME:-}"
  printf 'path=%s\n' "\${PATH:-}"
} >>"$LOG" 2>&1

# 业务命令的退出码单独保留，便于区分路径错误和业务失败
/srv/report-job/bin/run-report.sh >>"$LOG" 2>&1
status=$?
printf 'exit_code=%s\n' "$status" >>"$LOG"
exit "$status"

如果日志中的 pwd 与项目根目录不符，就说明相对路径基准变了；如果 command not found，优先看 PATH 或改用命令绝对路径；如果出现权限错误，则继续核对执行用户、目录的搜索权限和日志目录的写权限。

发布前的四项检查

• 把 crontab 中的脚本、解释器、配置和日志路径逐个展开，确认没有裸文件名。
• 用目标执行用户检查目录的每一级是否可搜索、文件是否可读、日志目录是否可写。
• 不要假定登录 Shell 的别名、函数、~/.profile 或语言版本管理器会被 cron 自动加载。
• 先让任务写入专用诊断日志，确认 pwd、HOME、PATH 和退出码后，再接入正式告警。

常见问题

cron 的相对路径是不是总从用户 HOME 开始？

不是。HOME 是环境变量，路径解析基准是当前工作目录；不要把两者混为一谈。

只在 crontab 顶部设置 PATH 就够了吗？

它只能改善命令查找，不能解决配置文件、输出文件和脚本内部相对引用。关键文件仍建议使用绝对路径。

为什么脚本里写了相对配置路径还是失败？

脚本文件所在目录不会自动成为当前目录。可在入口处计算固定基准目录，或直接使用部署目录的绝对路径。

怎样区分路径问题和权限问题？

记录 pwd、执行用户和目标路径，再用该用户检查每级目录权限；找不到文件偏向路径基准，Permission denied 才进入权限排查。