90%的crontab脚本失败源于环境变量缺失；cron使用极简shell不加载用户配置，需通过env对比终端与cron环境差异，并在crontab开头显式声明shell、path、home等关键变量，同时脚本内应使用绝对路径并主动切换目录。

脚本在终端能跑，放进 crontab 就失败——90% 是环境变量缺失导致的。cron 启动时用的是极简 shell（/bin/sh），不加载 .bashrc、.profile，PATH 通常只有 /usr/bin:/bin，HOME、SHELL、PYTHONPATH 等全都不继承。排查关键不是猜，而是对比和显式控制。

确认 cron 实际运行环境

别凭经验假设，直接看 cron 真正用了什么环境：

• 在 crontab 中加一行测试：* * * * * env > /tmp/cron_env.txt 2>&1，等一分钟执行后，运行 cat /tmp/cron_env.txt 查看完整变量
• 同时在终端执行 env > /tmp/terminal_env.txt，用 diff /tmp/terminal_env.txt /tmp/cron_env.txt 对比差异，重点关注 PATH、HOME、SHELL、LANG、以及你脚本依赖的自定义变量（如 JAVA_HOME、PYTHONPATH）
• 特别注意：cron 的 HOME 通常是用户家目录，但如果是系统级任务（如 /etc/crontab 或 /etc/cron.d/ 下），HOME 可能为空或为 /root，需手动指定

在 crontab 中显式声明关键变量

不要依赖自动加载，把必须的变量写在 crontab 文件最开头（crontab -e 编辑）：

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

• SHELL=/bin/bash —— 避免默认 /bin/sh 不支持某些语法（如数组、[[ ]]）
• PATH=/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:/home/username/.local/bin —— 把你常用命令路径全列上；可用 echo $PATH 查终端实际值来参考
• HOME=/home/username —— 明确家目录，避免 ~ 展开失败或配置文件读取路径错误
• 如有需要，可追加自定义变量：PYTHONPATH=/path/to/venv/lib/python3.x/site-packages 或 JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64

验证脚本能否在干净环境中复现问题

模拟 cron 的极简环境，提前暴露问题：

• 运行：env -i /bin/bash -l -c 'echo $PATH; /path/to/script.sh' —— -i 清空所有变量，-l 模拟登录 shell（会加载 profile 类文件，但前提是 PATH 和 SHELL 已设对）
• 更严格模拟：env -i PATH=/usr/bin:/bin SHELL=/bin/bash HOME=/home/username /bin/bash -c '/path/to/script.sh'
• 如果这步就失败，说明问题已定位；修复后再放回 crontab，成功率大幅提高

脚本内部加固：不依赖外部环境

光靠 crontab 设置还不够，脚本自身也要健壮：

• 第一行写明解释器：#!/bin/bash 或 #!/usr/bin/env python3
• 开头主动切换工作目录：cd "$(dirname "$0")" || exit 1，避免相对路径失效
• 所有命令尽量用绝对路径，比如 /usr/bin/python3 而非 python3；可用 which python3 查真实路径
• 必要时在脚本里加载配置：source /home/username/.bashrc 2>/dev/null || true（加 || true 防止加载失败中断）