Java中定义全局配置常量首选public static final，适用于启动后不变的系统参数；推荐封装为不可变配置类并校验值；需避免可变对象、异常调用及循环依赖；可结合配置文件实现运行时灵活调整。
在 Java 中，用 public static final 定义全局配置常量是最常见、最直接的方式，适用于那些启动后永不改变的系统级参数（如最大并发数、超时毫秒值、默认重试次数等）。
用 public static final 声明基础常量
这类常量通常放在专门的配置类中（如 SystemConfig 或 Constants），修饰符顺序推荐为 public static final，类型明确，值在编译期或类初始化时确定：
public static final int MAX_CONCURRENT_TASKS = 16;public static final long DEFAULT_TIMEOUT_MS = 30_000L;public static final String DEFAULT_ENCODING = "UTF-8";
注意：基本类型和字符串字面量可直接赋值；若需运行时计算（如读取环境变量），应使用 static 块确保只执行一次，并仍标记为 final。
封装成不可变配置类（推荐进阶用法）
当配置项较多、存在逻辑分组或需校验时，建议定义一个工具类，用私有构造器防止实例化，并集中管理常量：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 声明为
public final class SystemConfig { private SystemConfig() {} } - 所有字段保持
public static final，且类型优先选不可变类（String、Integer、Duration等） - 对关键数值可加简单校验，例如：
public static final int MAX_CONCURRENT_TASKS = Math.max(1, Integer.getInteger("app.max.tasks", 16));
避免常见陷阱
虽然 final static 能保证引用不可变，但要注意：
- 若值是可变对象（如
ArrayList、自定义 POJO），仅声明final无法阻止其内部状态变化 —— 应改用不可变容器（ImmutableList）或返回副本（Collections.unmodifiableList(...)） - 不要在常量中直接调用可能抛异常或依赖外部状态的方法（如
Files.readAllLines(...)），否则类加载失败 - 避免循环依赖：常量类不应依赖 Spring 上下文或其他尚未初始化的组件
配合配置文件的柔性方案
纯代码常量适合固定值；若需运行时调整，可结合 application.properties 或 application.yml，再通过 @Value 或 @ConfigurationProperties 注入。此时常量类可退为“默认值提供者”：
@Value("${app.max.tasks:${SYSTEM_MAX_TASKS:16}}") private int maxTasks;- 其中
${SYSTEM_MAX_TASKS:16}表示优先查系统属性，未设置则用常量类里的默认值
这样既保留了代码可读性与编译期检查，又支持部署灵活配置。
