Java 應用中獲取與操作系統屬性完全指南

前言

Java 「一次編寫，到處執行」的跨平台特性，要求程式在運行時能動態感知作業系統、JDK 版本、用戶目錄等環境差異。java.util.Properties 類作為系統屬性的核心載體，提供了統一的訪問介面。本文系統梳理系統屬性的獲取、自定義屬性文件操作及安全策略配置。

核心 API 概覽

常用系統屬性速查表

實戰範例：跨平台路徑構建

public class PathResolver {
    private static final String SEP = System.getProperty("file.separator");
    
    public static String buildPath(String... parts) {
        return String.join(SEP, parts);
    }
    
    public static void main(String[] args) {
        // Windows: config\app.properties
        // Linux:   config/app.properties
        String path = buildPath("config", "app.properties");
        System.out.println("Resolved path: " + path);
    }
}

自定義屬性文件：外部化配置最佳實踐

將易變配置（資料庫連線、功能開關、閾值參數）剝離出代碼，放入 .properties 文件：

1. 文件結構

# app-config.properties
# 資料庫配置
db.url=jdbc:mysql://localhost:3306/mydb?useSSL=false
db.username=app_user
db.password=encrypted_pwd

# 功能開關
feature.newDashboard.enabled=true
feature.legacyReport.enabled=false

# 業務閾值
batch.maxRecords=5000
cache.ttlSeconds=3600

2. 載入工具類（支援熱重載）

public final class ConfigLoader {
    private static final Logger log = LoggerFactory.getLogger(ConfigLoader.class);
    private static final String CONFIG_FILE = "app-config.properties";
    private static volatile Properties props = new Properties();
    private static long lastModified = 0;
    private static final Object lock = new Object();
    
    public static String get(String key) {
        return get(key, null);
    }
    
    public static String get(String key, String defaultValue) {
        maybeReload();
        return props.getProperty(key, defaultValue);
    }
    
    public static int getInt(String key, int defaultValue) {
        String val = get(key);
        try { return val != null ? Integer.parseInt(val) : defaultValue; }
        catch (NumberFormatException e) { return defaultValue; }
    }
    
    private static void maybeReload() {
        File file = new File(CONFIG_FILE);
        if (file.exists() && file.lastModified() > lastModified) {
            synchronized (lock) {
                if (file.lastModified() > lastModified) {
                    try (InputStream in = new FileInputStream(file)) {
                        Properties newProps = new Properties();
                        newProps.load(in);
                        props = newProps;
                        lastModified = file.lastModified();
                        log.info("配置已熱重載: {}", CONFIG_FILE);
                    } catch (IOException e) {
                        log.error("配置重載失敗", e);
                    }
                }
            }
        }
    }
}

安全策略文件：精細權限控制

Java 安全管理器依賴 policy 文件授予代碼權限。三級策略加載順序：

1. 系統策略：${java.home}/conf/security/java.policy (JDK 9+) 或 lib/security/java.policy
2. 用戶策略：${user.home}/.java.policy
3. 應用指定：-Djava.security.policy=app.policy

典型應用策略範例

// app.policy
grant codeBase "file:/opt/myapp/-" {
    // 僅允許讀取特定系統屬性
    permission java.util.PropertyPermission "user.dir", "read";
    permission java.util.PropertyPermission "app.config.*", "read,write";
    
    // 資料庫連線權限
    permission java.net.SocketPermission "db-server:3306", "connect,resolve";
    
    // 檔案讀寫權限（限定目錄）
    permission java.io.FilePermission "/var/data/myapp/-", "read,write,delete";
    
    // 禁止危險操作
    // permission java.lang.RuntimePermission "createClassLoader"; // 不授予
};

啟動參數

java -Djava.security.manager \
     -Djava.security.policy==app.policy \
     -jar myapp.jar

注意 == 表示僅使用指定策略，忽略系統/用戶策略；單 = 表示追加。

現代化替代方案

Spring Boot / MicroProfile Config 提供了更強大的配置管理：

• 多來源疊加：YAML、Properties、環境變量、Consul、Nacos
• 類型安全綁定：@ConfigurationProperties 映射到 POJO
• 動態刷新：@RefreshScope / ConfigSource 變更事件
• 加密解密：Jasypt、Vault 整合

新專案建議直接採用框架級配置體系，僅在獨立 Java 應用或舊系統維護中使用原生 Properties。

總結

1. System.getProperties() 提供唯讀系統環境視圖，跨平台開發必備。
2. 自定義 .properties 實現配置外部化，結合熱重載提升運維效率。
3. 安全策略文件實現最小權限原則，保護生產環境安全。
4. 現代框架已內建更完善的配置抽象，優先選用框架方案。