怎样调试服务器运维Shell脚本

调试服务器运维类 Shell 脚本，核心目标是快速定位问题、减少误操作和避免生产事故。下面从「基础习惯 → 调试手段 → 实战技巧 → 安全建议」四个层次讲。

一、写脚本时就要“可调试”

1. 开头加严格模式（非常重要）

#!/bin/bash
set -euo pipefail

• -e：命令失败立即退出
• -u：使用未定义变量报错
• -o pipefail：管道中任意命令失败都算失败

运维脚本强烈建议默认开启，避免“继续执行导致雪崩”

2. 使用函数而不是一长串命令

backup_mysql() {
  ...
}

clean_logs() {
  ...
}

好处：

• 出错能精确定位
• 可单独测试函数

二、常用调试手段（从轻到重）

✅ 1. bash -x 最常用

bash -x script.sh

或脚本里加：

set -x

会显示：

• 实际执行的命令
• 变量展开后的值

适合：

• 看“到底执行了啥”
• 查变量是否为空

✅ 2. echo / printf 打点（简单粗暴）

echo "当前用户: $USER"
echo "备份目录: $BACKUP_DIR"

建议：

log() {
  echo "[$(date +%F_%T)] $*"
}

✅ 3. 检查变量和命令是否存在

: "${MYSQL_USER:?未设置 MYSQL_USER}"
command -v rsync >/dev/null || exit 1

✅ 4. 分段执行（不要一跑到底）

bash -x script.sh --dry-run

或加参数：

DRY_RUN=1 ./script.sh

if [ "${DRY_RUN:-0}" -eq 1 ]; then
  echo "模拟执行: rm -rf $DIR"
else
  rm -rf "$DIR"
fi

三、服务器运维特有调试技巧

1. 先“预览”再执行危险命令

find /var/log -name "*.log" -mtime +30 -print
# 确认无误再
find /var/log -name "*.log" -mtime +30 -delete

2. 用 set -x + 日志文件

exec > /var/log/script.log 2>&1
set -x

3. 检查返回值

systemctl restart nginx
if [ $? -ne 0 ]; then
  echo "nginx 重启失败"
  exit 1
fi

或更好：

systemctl restart nginx || {
  echo "nginx 重启失败"
  exit 1
}

4. 对环境变量敏感

env | grep -E "PATH|HOME|USER"

服务器上常因：

• cron 环境不全
• sudo 丢环境变量

四、生产服务器调试安全原则（很重要）

❌ 禁止

• 在线上直接 vim 改脚本并跑
• rm -rf $DIR/ 不加引号
• 在脚本里写死密码

✅ 推荐

• 先在测试机 / 容器跑
• 使用 set -euo pipefail
• 所有删除操作先 --dry-run
• 关键操作加确认：

read -p "确认删除 $DIR? y/N: " confirm

五、一个“可调试运维脚本”模板

#!/bin/bash
set -euo pipefail

LOG=/var/log/ops.log
log() { echo "[$(date +%F_%T)] $*" | tee -a "$LOG"; }

backup() {
  log "开始备份"
  rsync -a /data/ /backup/ || exit 1
}

main() {
  backup
  log "完成"
}

main "$@"

如果你愿意，可以：

• 贴一段你正在调试的脚本
• 或说明是 cron / systemd / 手动执行 / Docker 内

我可以直接帮你定位具体问题。