Linux 中怎么为运维脚本编写详细的错误提示-linux运维-PHP中文网

linux运维脚本错误提示需包含位置（$0:$lineno）、原因、可操作验证命令，如“error [backup.sh:42]: rsync failed — check ssh key and /backups permissions”，并重定向至stderr、记录日志。

linux 中怎么为运维脚本编写详细的错误提示

在 Linux 运维脚本中，清晰、具体的错误提示不是“报错就行”，而是要让执行者（可能是你自己、同事或值班人员）一眼看懂：哪里错了、为什么错、怎么快速验证和修复。核心是上下文 + 可操作性，而非堆砌技术细节。

明确错误发生的位置和触发条件

不要只写 "Failed" 或 "Error occurred"。用 $0（脚本名）、$LINENO（行号）、关键变量值，锁定问题现场：

✅ 好的提示：ERROR [line 42 in backup.sh]: Failed to rsync /data/ to backup-server:/backups/ — remote directory not writable (check SSH key and /backups permissions)
❌ 模糊提示：Error: rsync failed

可在关键命令后加判断，例如：

if ! rsync -a /data/ user@backup:/backups/; then
  echo "ERROR [$(basename $0):$LINENO]: rsync failed for /data/. Check network, SSH auth, and remote disk space." >&2
  exit 1
fi

区分错误类型，给出针对性建议

同一命令失败可能有多种原因。根据退出码、错误输出关键词或前置检查，分类提示：

权限问题 → 提示检查 ls -ld、id、sudo -l
路径不存在 → 提示确认 ls -l "$PATH_VAR" 或是否拼写错误
服务未运行 → 提示执行 systemctl status nginx 或 ss -tlnp | grep :80
磁盘满 → 提示 df -h /var 和 du -sh /var/log/* | sort -hr | head -3

可结合 case $? in 或 grep -q 匹配常见错误字符串，动态生成提示。

Obsidian (Linux)

操作 Obsidian 库（纯 Markdown 笔记），并通过 notesmd-cli 实现自动化。

下载

提供最小验证步骤，降低排查成本

运维最怕“看到报错却不知从哪下手”。每个错误提示末尾，附带 1–2 条终端可直接复制粘贴的验证命令：

ERROR: MySQL connection refused on localhost:3306 — verify with: mysqladmin -u root -p ping && echo OK || echo "Check mysqld status: systemctl status mysqld"
WARNING: Cert file /etc/letsencrypt/live/example.com/fullchain.pem missing — renew with: certbot renew --dry-run

避免笼统说“请检查配置”，而是告诉用户“检查哪一行”“运行哪条命令”“预期输出是什么”。

统一格式 + 日志分级，便于后续追踪

所有错误使用固定前缀（如 ERROR、WARN、FATAL），并重定向到 stderr；关键信息用 font color="red"（仅限终端显示时）或加粗增强识别：

echo "<font color="red">FATAL [$0:$LINENO]</font>: No free inodes on /tmp. Clean up with: find /tmp -type f -mtime +7 -delete" >&2

同时，将完整错误连同时间戳、环境变量（如 $(date), $(hostname), $(whoami)）记入日志文件，方便事后审计：

echo "$(date '+%Y-%m-%d %H:%M:%S') ERROR [$0:$LINENO] $MSG" >> /var/log/myscript.log

不复杂但容易忽略：错误提示不是写给机器看的，是写给下一个打开终端的人看的。多花 10 秒写清楚，能省下别人 10 分钟排查时间。