Java项目启动前环境校验核心是提前暴露配置、依赖、权限等问题，涵盖JDK版本与JAVA_HOME校验、关键配置合法性检查、核心外部服务连通性预检、磁盘空间与临时目录就绪检查，并建议封装为独立Starter模块。
Java项目启动前的环境校验，核心目标是提前暴露配置、依赖、权限等基础问题，避免服务启动失败或运行时异常。重点不是“能不能跑”，而是“有没有准备好稳定运行的条件”。
JDK版本与JAVA_HOME校验
很多项目明确要求JDK 8/11/17等特定版本，但实际运行时可能因系统PATH中存在旧版JDK导致误用。需在启动脚本（如startup.sh或ApplicationRunner）中主动读取System.getProperty("java.version")和System.getenv("JAVA_HOME")，比对预期版本范围。
- 建议使用语义化版本比较（如Apache Commons Lang的VersionUtils），而非简单字符串startsWith
- 若JAVA_HOME为空或指向jre而非jdk，应明确报错而非静默降级
- 可额外检查javax.crypto.Cipher是否可用，验证JCE策略完整性（尤其金融类项目）
关键配置项存在性与合法性检查
避免因application.yml缺失、占位符未填充、敏感配置为空导致启动卡死或后续NPE。应在Spring Context刷新前介入校验。
- 提取所有@Value("${xxx}")和@ConfigurationProperties绑定类，扫描必填字段（标注@NotBlank或@NotNull）
- 对数据库URL、Redis地址、文件路径等做基础格式校验（如URL是否含协议、路径是否存在可写权限）
- 敏感配置如密钥、Token建议加长度校验（如AES密钥必须为16/24/32字节）
外部服务连通性预检
不是全量探测所有依赖服务，而是聚焦“启动即需”的核心依赖（如配置中心、注册中心、主库），防止服务注册成功后才报连接超时。
- 对Nacos/Eureka/ZooKeeper，尝试建立轻量连接并获取一次服务列表（不订阅）
- 对MySQL/PostgreSQL，执行SELECT 1；对Redis，执行PING；超时统一设为3秒内
- 注意：预检失败应中断启动，但需提供开关（如--skip-precheck）供本地调试绕过
磁盘空间与临时目录就绪检查
日志归档、文件上传、JVM Dump等场景依赖磁盘空间和临时目录，线上常因/tmp满或挂载点只读导致服务假死。
- 检查System.getProperty("java.io.tmpdir")所在分区剩余空间（建议≥500MB）
- 验证日志目录（如logback.xml中
路径）是否可写，父目录是否存在 - 对使用MappedByteBuffer或堆外内存的组件（如Netty、Elasticsearch client），可预估最小所需空间并校验
这些检查宜封装为独立的Starter模块，通过Spring Boot的ApplicationContextInitializer
或ApplicationRunner触发，失败时输出结构化错误码与修复指引。不复杂但容易忽略。
