优雅校验配置非空并抛出异常的技巧

本文介绍在 Java 静态初始化块中，通过封装校验逻辑（而非重复 if 判空）来确保所有必需配置项均被正确加载且不为 null，避免手动逐个检查的冗余代码。

本文介绍在 Java 静态初始化块中，通过封装校验逻辑（而非重复 if 判空）来确保所有必需配置项均被正确加载且不为 null，避免手动逐个检查的冗余代码。

在构建配置驱动型应用（如基于 application.properties 的 Spring Boot 外部化配置替代方案）时，确保关键系统属性在启动时完整、非空至关重要。若缺失某项（例如 aws.bucket.digitalassetsuploads），程序应立即失败并给出明确错误，而非延迟到运行时因 NullPointerException 崩溃。

最简洁、可维护的实践是将“读取 + 非空校验”封装为一个私有静态工具方法，而非为每个字段添加独立的 if (x == null) throw ...。如下所示：

import java.io.IOException;
import java.util.Properties;

public class AppProperties {

    public static final String DIGITAL_ASSETS_UPLOADS_BUCKET;
    public static final String REGION;
    public static final String APP_PEEFIX;  // 注意：原代码中拼写为 PEERFIX，此处保留原文拼写
    public static final String ACCOUNT_NUMBER;
    public static final String TEXTRACT_SSM_SNS_NAME;
    public static final String TEXTRACT_SSM_SQS_NAME;

    static {
        Properties prop = new Properties();
        try {
            prop.load(AppProperties.class.getClassLoader()
                .getResourceAsStream("application.properties"));
        } catch (IOException e) {
            throw new RuntimeException("Failed to load application.properties from classpath", e);
        }

        // 统一使用安全读取方法，自动校验非空
        DIGITAL_ASSETS_UPLOADS_BUCKET = getNonNullProperty(prop, "aws.bucket.digitalassetsuploads");
        REGION = getNonNullProperty(prop, "aws.region");
        APP_PEEFIX = getNonNullProperty(prop, "cdk.appprefix");
        ACCOUNT_NUMBER = getNonNullProperty(prop, "aws.accountnumber");
        TEXTRACT_SSM_SNS_NAME = getNonNullProperty(prop, "aws.ssm.sns.textract");
        TEXTRACT_SSM_SQS_NAME = getNonNullProperty(prop, "aws.ssm.sqs.textract");
    }

    /**
     * 安全获取配置值：若指定 key 不存在或值为 null，则抛出 RuntimeException
     * @param props 配置源
     * @param key 属性键名
     * @return 非空字符串值
     */
    private static String getNonNullProperty(Properties props, String key) {
        String value = props.getProperty(key);
        if (value == null || value.trim().isEmpty()) {
            throw new RuntimeException("Missing or empty required property: '" + key + "'");
        }
        return value.trim(); // 自动去除首尾空白，增强健壮性
    }
}

✅ 优势说明：

• 单一职责清晰：getNonNullProperty 专注“读取 + 校验”，与业务逻辑解耦；
• 错误信息精准：异常消息直接包含缺失的 key，便于快速定位问题配置项；
• 空字符串防护：扩展支持 trim().isEmpty()，防止配置文件中误填空格导致逻辑异常；
• 零依赖、零注解：无需引入额外框架或编译期注解处理器（如 @NotNull + Checker Framework），纯 Java 标准实现；
• 易于扩展：后续新增配置项只需一行调用，无需修改校验逻辑。

⚠️ 注意事项：

• 此方案适用于启动即校验场景（如 static 块），不适用于动态重载配置；
• 若需更高级能力（如类型转换、默认值回退、分组校验），建议迁移到 Spring Boot 的 @ConfigurationProperties 或 Jakarta Config 等标准化配置管理方案；
• 生产环境建议配合配置中心（如 AWS Systems Manager Parameter Store）与 CI/CD 阶段的配置 Schema 校验，实现多层防护。

该模式虽无 Kotlin 的 by lazy { requireNotNull(...) } 那般语法糖，但以极简、可控、可读的方式达成了同等可靠性目标——让失败发生在最早、最明确的时刻。