System.setProperty()仅能修改System内部Properties中的键值对（如"file.encoding"），不能更改JVM启动参数或SecurityManager锁定的属性；修改后是否生效取决于下游代码是否在运行时动态读取该属性。
System.setProperty() 能改哪些配置
它只能修改 java.lang.System 内部维护的 Properties 对象里的键值对，也就是通过 System.getProperty() 能读到的那些。比如 "file.encoding"、"user.dir"、"my.custom.config" 这类自定义键。但它**不能**改变 JVM 启动参数（如 -Xmx、-Djava.awt.headless 的初始值），也不能覆盖已由 SecurityManager 锁定的系统属性（如 "java.home" 在某些受限环境会抛 SecurityException）。
调用时机和可见范围很关键
System.setProperty() 是线程安全的，但修改后是否生效，取决于下游代码何时读取该属性：
- 如果其他模块在你的修改**之前**就调用过
System.getProperty("xxx")并缓存了结果（比如 Log4j2 在初始化时读一次"log4j.configurationFile"），那后续改了也没用 - Spring Boot 的
@Value("${my.prop}")默认只在启动时绑定，运行时改System.setProperty()不会触发刷新（除非配合@RefreshScope+ Spring Cloud Config 等机制） - 多个 ClassLoader 下可能看到不同值：父加载器设的属性，子加载器能读到；但子加载器自己 set 的，父加载器读不到（因为每个 ClassLoader 拿到的
System是同一个，但实际使用逻辑可能绕过它）
常见误用和报错场景
最典型的失败不是语法错误，而是“改了但没反应”。排查时优先确认：
- 目标库是否真在运行时读取该属性？查源码或文档，例如
org.apache.commons.io.FileUtils会动态读"line.separator"，但java.nio.file.Paths不会 - 是否被 SecurityManager 阻止？错误信息是
java.lang.SecurityException: attempt to access system property xxx；此时需在策略文件中显式授权，或干脆不用此方式 - 拼写大小写错误：
"User.dir"和"user.dir"是两个键；JVM 标准属性基本全小写加点号 - 传 null 值会导致
NullPointerException——System.setProperty("k", null)不合法，必须用System.clearProperty("k")清除
一个可验证的最小示例
下面这段代码能立刻看到效果，适合调试：
public class PropTest {
public static void main(String[] args) {
System.out.println("before: " + System.getProperty("test.key")); // null
System.setProperty("test.key", "runtime_value");
System.out.println("after: " + System.getProperty("test.key")); // runtime_value
// 注意：如果这里启动了新线程或第三方组件，它们能否感知取决于其内部实现
}
}
真正难的是让框架或中间件响应这个变更——多数情况下，它们只在初始化阶段采样一次系统属性，之后就不再监听。所以别指望靠它热更新数据库连接池大小或日志级别，除非你清楚知道那个组件明确支持运行时重读系统属性。
