Java RMI 遠程方法調用完整實戰指南：從接口定義到服務部署

前言：RMI 是 Java 原生的分布式物件模型

Java RMI (Remote Method Invocation) 讓執行在不同 JVM (甚至不同機器) 的物件能像本地呼叫一樣透明地調用遠程物件方法。雖然 gRPC、Dubbo、Spring Cloud 等現代 RPC 框架功能更強，但 RMI 作為 **Java 標準庫零依賴** 的分布式基礎設施，理解其核心架構 (Stub/Skeleton、Registry、序列化、代碼下載) 對掌握分布式系統本質、排查微服務通訊問題、維護老舊系統具有不可替代的價值。本文完整演示 RMI 開發全流程：遠程接口、實現類、服務端啟動、客戶端調用、安全策略、常見錯誤排查。

一、RMI 核心架構組件

二、完整開發步驟與代碼實現

2.1 遠程接口

import java.rmi.Remote;
import java.rmi.RemoteException;
import java.util.List;

public interface UserService extends Remote {
    // 所有方法必須拋出 RemoteException
    User getUserById(long id) throws RemoteException;
    List getAllUsers() throws RemoteException;
    boolean addUser(User user) throws RemoteException;
    boolean updateUser(User user) throws RemoteException;
    boolean deleteUser(long id) throws RemoteException;
}

2.2 可序列化資料物件

import java.io.Serializable;

public class User implements Serializable {
    private static final long serialVersionUID = 1L; // 必須顯式聲明
    private long id;
    private String name;
    private int age;
    // 建構子、getter/setter、toString...
}

2.3 遠程物件實現

import java.rmi.RemoteException;
import java.rmi.server.UnicastRemoteObject;
import java.util.*;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.atomic.AtomicLong;

public class UserServiceImpl extends UnicastRemoteObject implements UserService {

    private final Map users = new ConcurrentHashMap<>();
    private final AtomicLong idGen = new AtomicLong(1);

    // 建構子必須拋出 RemoteException
    public UserServiceImpl() throws RemoteException {
        super(); // 呼叫父類建構子，導出物件 (監聽匿名埠)
    }

    @Override
    public User getUserById(long id) throws RemoteException {
        return users.get(id);
    }

    @Override
    public List getAllUsers() throws RemoteException {
        return new ArrayList<>(users.values());
    }

    @Override
    public boolean addUser(User user) throws RemoteException {
        if (user.getId() == 0) user.setId(idGen.getAndIncrement());
        return users.put(user.getId(), user) == null;
    }

    @Override
    public boolean updateUser(User user) throws RemoteException {
        return users.replace(user.getId(), user) != null;
    }

    @Override
    public boolean deleteUser(long id) throws RemoteException {
        return users.remove(id) != null;
    }
}

2.4 服務端啟動類

import java.rmi.registry.LocateRegistry;
import java.rmi.registry.Registry;
import java.rmi.Naming;

public class RMIServer {
    public static void main(String[] args) {
        try {
            // 1. 建立並導出遠程物件
            UserService service = new UserServiceImpl();

            // 2. 啟動 Registry (嵌入式，同進程) - 埠 1099
            // 生產環境建議獨立進程: `rmiregistry 1099 &`
            Registry registry = LocateRegistry.createRegistry(1099);

            // 3. 綁定名稱 (URL 格式: rmi://host:port/name)
            String serviceName = "UserService";
            registry.rebind(serviceName, service); // rebind 覆蓋舊綁定
            // 或 Naming.rebind("rmi://localhost:1099/UserService", service);

            System.out.println("RMI 服務已啟動，綁定名稱: " + serviceName);
            System.out.println("等待客戶端調用...");

            // 4. 添加關閉鉤子優雅關閉
            Runtime.getRuntime().addShutdownHook(new Thread(() -> {
                try { UnicastRemoteObject.unexportObject(service, true); } catch (Exception ignored) {}
                System.out.println("RMI 服務已關閉");
            }));

        } catch (Exception e) {
            e.printStackTrace();
            System.exit(1);
        }
    }
}

2.5 客戶端調用類

import java.rmi.registry.LocateRegistry;
import java.rmi.registry.Registry;
import java.rmi.Naming;
import java.util.List;

public class RMIClient {
    public static void main(String[] args) {
        String host = (args.length > 0) ? args[0] : "localhost";
        int port = 1099;
        String serviceName = "UserService";
        String url = "rmi://" + host + ":" + port + "/" + serviceName;

        try {
            // 1. 從 Registry 查找遠程物件 (返回 Stub 代理)
            Registry registry = LocateRegistry.getRegistry(host, port);
            UserService service = (UserService) registry.lookup(serviceName);
            // 或 UserService service = (UserService) Naming.lookup(url);

            System.out.println("成功獲取遠程服務代理: " + service.getClass().getName());

            // 2. 像本地呼叫一樣調用遠程方法
            service.addUser(new User(0, "張三", 25));
            service.addUser(new User(0, "李四", 30));
            
            System.out.println("所有用戶:");
            for (User u : service.getAllUsers()) {
                System.out.println("  " + u);
            }

            User u = service.getUserById(1);
            System.out.println("ID=1 用戶: " + u);

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

三、關鍵配置與部署細節

3.1 安全策略文件 (server.policy / client.policy)

RMI 預設啟用 SecurityManager，**必須授權** 代碼庫權限。
建立 server.policy：

grant codeBase "file:./bin/-" { // 或 jar 路徑
    permission java.security.AllPermission; // 開發測試用，生產最小權限
};

啟動參數：

java -Djava.security.policy=server.policy -Djava.rmi.server.hostname=192.168.1.100 RMIServer
java -Djava.security.policy=client.policy RMIClient

關鍵參數：java.rmi.server.hostname 指定 Stub 中嵌入的伺服器 IP (多網卡/NAT 環境必須設置，否則客戶端連不上)。

3.2 獨立 Registry 進程 (生產推薦)

# 終端 1: 啟動獨立 Registry
rmiregistry 1099 &

# 終端 2: 啟動 Server (不再 createRegistry)
java -Djava.rmi.server.hostname=... RMIServer

優點：Registry 崩潰不影響服務邏輯進程，便於集群管理。

3.3 代碼下載 (動態 Stub/類傳輸)

• 客戶端若無 Stub 類/遠程接口/參數類定義，**需從代碼庫下載**。
• Server 端設置：-Djava.rmi.server.codebase=https://serverhost:8080/classes/ (HTTP 服務托管編譯後的 .class/JAR)。
• Client 端策略需授權 java.net.SocketPermission 連接代碼庫。
• **JDK 5+ 動態 Stub 生成** (動態代理) 已大幅減少代碼下載需求，但參數/返回值類仍需雙方共享定義。

四、常見錯誤與排查清單

五、RMI 進階主題

• 分散式垃圾回收 (DGC)：RMI 運行時追蹤遠程引用計數，無引用時自動清理 (Lease 續租機制)。
• RMI over SSL (RMI/SSL)：javax.rmi.ssl.SslRMIClientSocketFactory + SslRMIServerSocketFactory，雙向認證加密傳輸。
• 激活機制：rmid (Activation Daemon) 支援遠程物件按需啟動、持久化狀態。
• 自定義 Socket Factory：實現 RMIClientSocketFactory/RMIServerSocketFactory 控制連接行為 (超時、壓縮、代理、SOCKS)。

六、現代替代方案對比

結語

Java RMI 以**遠程接口 + 序列化 + Stub 代理 + Registry 命名**構建了經典的分布式物件模型。掌握其開發全流程 (接口→實現→服務端→客戶端)、關鍵配置 (SecurityManager、hostname、codebase)、常見網路/序列化/安全錯誤排查，是 Java 後端工程師的基本功。在現代微服務架構中，RMI 多作為**內部模組通訊、測試存根、老系統整合**的輕量選擇；核心業務交互已遷移至 gRPC/Dubbo 等高性能、治理完善的 RPC 框架。但 **RMI 的設計思想 (位置透明、代理模式、序列化邊界、命名服務)** 深刻影響了後續所有 RPC 框架的架構演進。

1. 上一篇文章： Java 內部類訪問權限深度解析：編譯器生成合成建構子的隱藏機制
2. 下一篇文章： Java 多執行緒控制圖像分割重組：實現拼圖遊戲核心邏輯

Java 程式設計入門

Java 調用 GDAL 原生庫（DLL/so）完整配置指南

GDAL（Geospatial Data Abstracti

Eclipse 3.1 泛型支持全解析：編譯器設置、錯誤警告配置與重構工具實戰

前言：工具對語言變革的響應速度決定生產力 Java 5 泛型

Java Web Filter 完整指南：核心概念、生命週期與鏈式調用實戰

什麼是 Filter？ 在 Java Web 開發中，Fil

Java 方法詳解：定義、呼叫、重載、遞迴與最佳實踐

Java 方法詳解：定義、呼叫、重載、遞迴與最佳實踐 方法是