Bash脚本在crontab执行失败：路径未完全限定问题解析与优化

我编写了一个Bash脚本，用于每晚通过cron备份Minecraft服务器，脚本内容如下：

#!/usr/bin/env bash
#
# Usage:
#   backup_server.sh <name>
#
# Options:
#   -h, --help                 Show this screen.
#   --version                  Show version.

set -euo pipefail

#shellcheck disable=SC1091
source /opt/minecraft/bin/docopts.sh
source /opt/minecraft/scripts/mc_functions.sh

rcon() {
  local command=$1
  if [ "$server_name" != "proxy" ] && mc_server_online "$server_name" ; then
    /opt/minecraft/bin/mcrcon "$command"
  fi
}

main() {
  local version='1.0.0'
  usage=$(docopt_get_help_string "$0")
  eval "$(docopts -A ARGS -V "$version" -h "$usage" : "$@")"

  local server_name=${ARGS[<name>]}
  local source=$MC_SERVER_ROOT/$server_name
  local destination=$MC_BACKUP_ROOT/$server_name

  [ -d "$source" ] || { 
    printf "A server named '%s' does not exist.\n" "$server_name" >&2
    exit 1
  }

  mc_set_rcon_credentials "$server_name" || { 
    printf "Failed to set the rcon credentials for the server '%s'.\n" "$server_name" >&2
    exit 1
  }

  rcon "save-off"
  rcon "save-all"
  mkdir -p "$destination"
  tar -cpvzf "$destination/$(date +%F-%H-%M).tar.gz" "$source" >&2
  rcon "save-on"

  unset MCRCON_PASS
  unset MCRCON_PORT

  find "$MC_BACKUP_ROOT" -type f -mtime +7 -name "*.gz" -delete
}

main "$@"

之前我在source命令或mcrcon调用中未使用完全限定路径，因为这些文件在终端的$PATH中，脚本在终端运行毫无问题。但放到crontab中执行时，脚本因无法找到可执行文件或脚本失败，我猜测这和cron无法读取/使用终端的$PATH有关？

我的crontab配置如下：

0 1 * * * bash /opt/minecraft/scripts/backup_server.sh proxy
# 还有几个类似的命令，仅服务器名称不同

想请教两个问题：

1. 为什么在cron环境中执行脚本需要使用完全限定路径？
2. 有没有更简便的实现方式？

一、cron环境需要完全限定路径的原因 #

cron的运行环境和终端登录环境差异很大：

• cron的默认$PATH非常精简，通常只有/usr/bin:/bin这类系统基础路径，不会包含你在终端里配置的自定义路径（比如/opt/minecraft/bin）
• cron不会加载用户的shell配置文件（比如~/.bashrc、~/.profile），所以终端里设置的$PATH、自定义环境变量都不会生效
• 当脚本用相对路径调用命令或脚本时，cron只能在默认$PATH里查找，找不到就会抛出"command not found"错误

二、更简便的实现方式 #

1. 在脚本开头自定义$PATH #

在脚本的set -euo pipefail语句之后，添加一行自定义$PATH的代码，把你需要的路径追加进去：

export PATH="/opt/minecraft/bin:/opt/minecraft/scripts:$PATH"

这样脚本不管在终端还是cron中运行，都能找到所需的命令和脚本，无需再写完全限定路径。

2. 在crontab中全局设置$PATH #

直接在crontab的开头添加PATH配置，覆盖默认路径：

PATH=/usr/bin:/bin:/opt/minecraft/bin:/opt/minecraft/scripts
0 1 * * * bash /opt/minecraft/scripts/backup_server.sh proxy
# 其他备份命令...

这种方式适合多个cron任务需要使用相同自定义路径的场景，一次配置所有任务生效。

3. 让cron任务读取终端环境变量 #

如果你的自定义路径是写在~/.profile里的，可以在crontab命令前先加载这个文件：

0 1 * * * . ~/.profile && bash /opt/minecraft/scripts/backup_server.sh proxy

注意：这种方式要确保~/.profile里没有只适合终端交互的配置，避免影响cron任务运行。

4. 给脚本添加可执行权限，简化调用 #

先给脚本添加可执行权限：

chmod +x /opt/minecraft/scripts/backup_server.sh

然后crontab里可以直接调用脚本，无需指定bash：

0 1 * * * /opt/minecraft/scripts/backup_server.sh proxy

结合前面的$PATH配置，能让crontab命令更简洁。

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