只有编译期能确定值的static final基本类型或String字段才被JVM视为“类常量”并内联，运行期初始化、包装类、非常量表达式、数组/集合等均不符合；修改后需重编译依赖方才能生效。
Java里static final字段为什么算“类常量”
只有编译期能确定值的static final基本类型或String字段，才会被JVM当作“类常量”（class constant），直接内联到调用处。不是所有static final都算——比如static final int x = new Random().nextInt();这种运行期才确定的值，就只是普通静态字段，不会内联。
- 必须是基本类型（
int、boolean等）或String；Integer、Boolean等包装类不行（哪怕值是字面量） - 初始化表达式必须是编译时常量表达式，比如
1 + 2、"a" + "b"可以，Integer.valueOf(42)或System.getProperty("os.name")不行 - 字段必须用
public static final声明（访问修饰符不影响是否为常量，但影响能否被其他类内联；如果包外访问不到，自然无法内联）
类常量被修改后，依赖它的类不重新编译就看不到新值
这是最常踩的坑：A类定义了public static final String VERSION = "1.0";，B类引用它并编译过；之后只改A类的值为"1.1"，却不重编译B类——B类运行时仍打印"1.0"。因为Javac在编译B时已把"1.0"直接写进B的字节码，根本没去读A的class文件。
- 只要涉及公共API常量，发布新版本时务必确保所有下游模块重新编译
- 想避免这个问题？改用
public static String getVersion() { return "1.1"; }——方法调用不会内联，每次都是运行时取值 - Maven/Gradle中，若A是独立jar，B依赖它，则B项目需执行
clean compile，不能只靠IDE自动构建（有些IDE缓存太激进）
static final数组或集合不能当“类常量”用
数组和集合对象本身无法成为编译期常量，哪怕声明为static final。你只能保证引用不可变，但内容可变——这和真正意义上的常量语义冲突。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 错误写法：
public static final int[] CODES = {1, 2, 3};→CODES[0] = 99;完全合法，值变了 - 正确防护：用
Arrays.asList()转成不可修改列表，再用Collections.unmodifiableList()包裹；或者用java.util.ImmutableList.of()（Guava）或List.of()（Java 9+） - 注意
List.of()返回的是真正不可变的，但它的元素仍是可变对象（比如List.of(new Date())，Date本身仍可修改）
接口里的static final字段会被所有实现类继承，但别滥用
接口中定义public static final int MAX_RETRY = 3;，任何implements该接口的类都能直接用MAX_RETRY，甚至不用加接口名前缀。但这容易模糊职责边界，尤其当多个接口定义同名常量时，编译会报错。
立即学习“Java免费学习笔记（深入）”；
- Java 8+允许接口有
static方法，比堆常量更清晰；考虑把常量收拢到工具类（如RetryConfig），用public static方法返回值 - 如果真要用接口常量，确保名字带足够上下文，比如
HTTP_STATUS_NOT_FOUND比NOT_FOUND安全得多 - IDE里Ctrl+Click跳转可能跳到接口而非实现类，排查问题时容易误判作用域
