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 代码生成文档”时触发。

下载

• 声明为 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} 表示优先查系统属性，未设置则用常量类里的默认值

这样既保留了代码可读性与编译期检查，又支持部署灵活配置。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南