Java中配置常量需用public static final声明基本类型，引用类型须用unmodifiableXXX包装确保不可变；敏感配置应private+getter封装；枚举适用于有限预定义选项。
在 Java 中，用 final 定义配置常量，核心是确保其**编译期不可变、运行时不可重赋值、且语义上代表固定配置值**。关键不在“只是加 final”，而在于搭配 static、合适的访问修饰符和初始化方式，才能真正实现“不可被修改的配置常量”。
用 public static final 声明类级常量
配置常量通常属于整个类或系统，应声明为 static，避免每个实例都持有一份；public 便于其他类读取；final 禁止后续修改：
- 基本类型（如
int,String）：直接赋字面量或编译期常量表达式，JVM 会内联优化 - 引用类型（如
Map,List）：需确保对象本身也**不可变**（如用Collections.unmodifiableMap()包装）
示例：
public class AppConfig {
// ✅ 编译期常量（字符串字面量）
public static final String API_BASE_URL = "https://api.example.com";
// ✅ 数值常量
public static final int TIMEOUT_MS = 5000;
// ✅ 不可变集合（运行时保护）
private static final Map<String, String> HEADERS =
Collections.unmodifiableMap(new HashMap<>() {{
put("Content-Type", "application/json");
put("Accept", "application/json");
}});
public static Map<String, String> getHeaders() {
return HEADERS; // 返回不可修改视图
}
}
避免常见陷阱：final ≠ 对象内容不可变
final 只保证**引用不指向新对象**，不阻止对象内部状态改变。例如：
立即学习“Java免费学习笔记（深入）”；
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
public static final List<String> NAMES = new ArrayList<>();
NAMES.add("Alice"); // ✅ 合法 —— 引用没变，但内容变了
NAMES = new ArrayList<>(); // ❌ 编译错误 —— final 禁止重赋值
所以对集合、数组等，必须额外封装为不可变结构：
- 优先使用
java.util.Collections.unmodifiableXXX()方法包装 - 或选用 Guava 的
ImmutableList.of()、ImmutableMap.of() - 自定义类应设所有字段为
private final，不提供 setter，返回副本而非原始引用
推荐：配合 private + public getter 封装敏感配置
若配置不宜直接暴露（如密钥、数据库密码），建议设为 private static final，通过静态 getter 提供受控访问：
- getter 方法可加入权限检查、日志审计或解密逻辑（如从环境变量/加密存储读取）
- 避免硬编码敏感值，增强安全性与灵活性
示例：
public class SecretConfig {
private static final String ENCRYPTED_DB_PASSWORD = "a1b2c3..."; // 加密后存储
public static String getDbPassword() {
return decrypt(ENCRYPTED_DB_PASSWORD); // 运行时解密
}
private static String decrypt(String encrypted) {
// 实际解密逻辑（如 AES）
return "real_password";
}
}
进阶：用枚举定义有限、类型安全的配置选项
当配置项是预定义的有限集合（如环境类型、协议版本），用 enum 比 final 字符串更安全：
- 编译期类型检查，杜绝拼写错误
- 天然
final和static，实例唯一且不可变 - 可附加属性和方法，提升可读性与扩展性
示例：
public enum Environment {
DEV("https://dev-api.example.com", 3000),
STAGING("https://staging-api.example.com", 4000),
PROD("https://api.example.com", 5000);
private final String baseUrl;
private final int timeoutMs;
Environment(String baseUrl, int timeoutMs) {
this.baseUrl = baseUrl;
this.timeoutMs = timeoutMs;
}
public String getBaseUrl() { return baseUrl; }
public int getTimeoutMs() { return timeoutMs; }
}
