Java项目启动时须在Spring Context刷新前校验必填配置，包括扫描@Value和@ConfigurationProperties绑定项、检查存在性与合法性（如URL格式、密钥长度、超时值合理性），确保配置可用。

Java 项目启动时检查必填配置项，核心是“在 Spring Context 刷新前完成校验”，避免因配置缺失或非法导致服务启动后才报错、甚至假死。关键不在于“能不能做”，而在于“在哪做、做什么、怎么反馈”。

必填配置项的提取与扫描

Spring Boot 应用中，配置通常通过 @Value("${xxx}") 或 @ConfigurationProperties 绑定。校验需主动识别这些必填字段：

• 扫描所有 @Value 注解，提取占位符（如 ${db.url}），并检查对应配置是否已注入（非空且非默认占位符字符串）
• 遍历所有 @ConfigurationProperties 类，结合字段上的 @NotBlank、@NotNull、@Min 等约束注解，判定哪些字段为业务必填
• 对标注了 @Valid 的嵌套对象，递归校验其内部必填字段

合法性与完整性校验要点

光“存在”不够，还要“合法可用”：

• 基础格式：数据库 URL 检查是否含 jdbc: 协议；Redis 地址验证 host:port 格式；文件路径调用 Files.exists() + Files.isWritable()
• 敏感值强度：AES 密钥长度必须为 16/24/32 字节；JWT secret 建议 ≥32 字符；Token 类配置检查非空且长度 ≥10
• 数值合理性：超时时间不能 ≤0，线程池大小不能
• JCE 可用性（金融类重点）：运行 javax.crypto.Cipher.getInstance("AES/GCM/NoPadding")，捕获 NoSuchAlgorithmException 或 InvalidKeyException，确认 JCE 策略已正确安装

校验时机与执行机制

必须在 ApplicationContext 完全刷新前介入，推荐两种轻量级方式：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

立即学习“Java免费学习笔记（深入）”；

• ApplicationContextInitializer：实现接口，在 ConfigurableApplicationContext prepare 阶段执行，可访问 Environment，适合纯配置层校验
• ApplicationRunner：在 context refresh 后、应用 ready 前触发，能获取已初始化的 bean（如 Validator），适合需依赖校验器的复杂规则
• 两者都支持通过 --skip-precheck 参数跳过（本地开发调试用），失败时抛出 ApplicationContextException 中断启动，并输出结构化错误码（如 CONFIG_MISSING_DB_URL）和修复指引

封装成 Starter 复用更稳妥

把上述逻辑打包为独立 starter（如 spring-boot-starter-config-check），好处明显：

• 自动装配：通过 META-INF/spring.factories 注册 ApplicationContextInitializer
• 开箱即用：引入 starter 后无需额外编码，启动即生效
• 可配置化：提供 config-check.enabled=true、config-check.strict=true 等开关控制粒度
• 统一错误输出：日志中明确标出哪个 key 缺失、哪条规则不满足、建议如何修正

不复杂但容易忽略——真正起作用的不是“写了校验代码”，而是“它在 Spring 初始化链条里站对了位置、报错信息让人一眼看懂、线上环境能快速定位根因”。