根本原因是cron使用极简环境变量（PATH=/usr/bin:/bin），不加载~/.bashrc等配置，导致找不到java命令；解决方法包括用绝对路径调用、在crontab中显式设置PATH和JAVA_HOME，或通过/bin/bash -l -c模拟登录shell。
crontab里执行java命令报“command not found”
根本原因不是Java没装，而是cron启动的shell会话不读取你的~/.bashrc或~/.profile，PATH环境变量极简（通常只有/usr/bin:/bin），压根没包含$JAVA_HOME/bin。
- 别在crontab里直接写
java -version——它找不到 - 不要指望
source ~/.bashrc在cron里生效：非交互式shell默认不加载这些文件 - 验证方式：在crontab里加一行
* * * * * env > /tmp/cron_env.txt，看PATH值是否含java所在路径
在crontab中正确调用java的三种做法
优先级从高到低：显式路径 > 环境变量注入 > shell包装
- 最稳妥：用绝对路径调用
java，例如/opt/java-17/bin/java -jar /path/to/app.jar - 次选：在crontab条目开头设置
PATH和JAVA_HOME，例如：PATH=/opt/java-17/bin:/usr/local/bin:/usr/bin:/bin JAVA_HOME=/opt/java-17 * * * * * /opt/java-17/bin/java -cp /app/lib/* MyApp
- 慎用：用
/bin/bash -l -c 'java ...'模拟登录shell——有额外开销，且依赖~/.bash_profile中已正确配置
systemd服务比cron更可靠？
如果你的Java任务需要长期运行、重启策略或日志管理，systemd是更现代的选择。但要注意：systemd同样不自动继承用户环境变量。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 必须在service文件中显式声明：
[Service] Environment="JAVA_HOME=/opt/java-17" Environment="PATH=/opt/java-17/bin:/usr/local/bin:/usr/bin:/bin"
- 避免写
ExecStart=java ...，改用ExecStart=/opt/java-17/bin/java ... - 验证是否生效：
systemctl show --property=Environment myapp.service
容易被忽略的权限与工作目录陷阱
即使java命令能执行，也可能因其他环境差异失败。cron默认工作目录是用户HOME，而你的程序可能依赖相对路径读取配置或写日志。
- 始终在crontab中用
cd /path/to/app && ...明确工作目录 - 检查Java进程对目标目录是否有读写权限（尤其日志文件、临时目录）
- 若用
nohup或重定向，确保目标路径存在且可写，例如：nohup /opt/java-17/bin/java -jar app.jar > /var/log/app.log 2>&1 &
实际部署时，java命令本身只是表象；真正要锁定的是JAVA_HOME指向的路径是否稳定、PATH是否被cron会话识别、以及当前工作目录是否与代码预期一致——这三者缺一不可。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
