OperatingSystemMXBean.getTotalSwapSpaceSize() 返回操作系统交换空间理论总容量（字节），仅适用于Linux/macOS等Unix-like系统，Windows及容器中常返回0；需结合getFreeSwapSpaceSize()计算使用率，不可单独用于内存压力判断。
OperatingSystemMXBean.getTotalSwapSpaceSize() 是 Java 提供的一个 JMX 接口方法，用于获取操作系统当前配置的交换空间（swap）总大小（单位：字节）。它属于 java.lang.management.OperatingSystemMXBean，适用于 Linux、macOS 和部分支持 swap 的 Unix 系统，但在 Windows 上通常返回 0（Windows 使用页面文件 pagefile.sys，JVM 不通过此接口暴露其大小）。
这个值代表什么
它反映的是系统级 swap 分区或 swap 文件的**理论最大容量**，不是当前已使用或可用的量。例如：
- Linux 上用
swapon -s或free -m查到的 “Total” swap 行，与此值一致； - 该值在 JVM 运行期间一般不变（除非运行时增删 swap 分区，但极少见）；
- 返回
0并不一定表示无 swap——可能是未启用、权限不足，或平台不支持（如 Windows、某些容器环境）。
如何安全使用这个监控变量
调用前需注意兼容性与上下文：
- 先检查是否为 Unix-like 系统：
System.getProperty("os.name").toLowerCase().contains("linux")； - 建议配合
getFreeSwapSpaceSize()计算使用率，避免单独依赖 total 值做告警； - 在容器中（如 Docker），宿主机 swap 可能被禁用（
--memory-swap=-1或 cgroup v2 限制），此时该方法常返回0，不代表宿主机无 swap； - 需要
ManagementFactory.getOperatingSystemMXBean()获取实例，无需额外权限，但需 JVM 启动时未禁用 JMX。
常见误用和替代方案
直接用它判断“内存压力”容易误导：
- Java 应用自身不直接使用 swap，GC 和堆外内存行为更取决于物理内存与 JVM 参数（如
-XX:+UseZGC对 swap 不敏感）； - 真正影响性能的是 swap-in/out 频率（需查
/proc/vmstat中pgpgin/pgpgout），而非 total 大小； - 生产监控建议组合指标：JVM 堆使用率 +
getTotalPhysicalMemorySize()+ 系统free -h输出 + OOM Killer 日志。
代码示例（简洁可用）
以下为安全读取方式：
OperatingSystemMXBean osBean = ManagementFactory.getOperatingSystemMXBean();
if (osBean instanceof com.sun.management.UnixOperatingSystemMXBean) {
long totalSwap = ((com.sun.management.UnixOperatingSystemMXBean) osBean).getTotalSwapSpaceSize();
long freeSwap = ((com.sun.management.UnixOperatingSystemMXBean) osBean).getFreeSwapSpaceSize();
if (totalSwap > 0) {
double usageRate = (double) (totalSwap - freeSwap) / totalSwap;
// 上报或告警
}
}
