基于进程PID的本地JMX端口检测技术详解

原创 已于 2025-08-13 21:30:16 修改 · 309 阅读 · 4 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#开发语言 #jmx #java

于 2025-08-13 15:56:09 首次发布

引言

在Java应用开发中，我们经常需要获取运行中应用的各种信息，比如Spring Boot应用的端口号、配置参数等。传统的方式往往需要解析配置文件或日志输出，但这些方法不够可靠和实时。

本文将介绍一种更优雅的解决方案：基于进程PID的本地JMX端口检测技术。通过Java的JMX（Java Management Extensions）机制，我们可以直接连接到运行中的JVM进程，调用其中的MBean方法，获取应用的实时信息。

技术原理

什么是JMX？

JMX（Java Management Extensions）是Java平台提供的一套管理和监控框架，它允许我们：

  • 监控JVM的运行状态
  • 获取应用的配置信息
  • 动态调用应用中的方法
  • 实时查看应用指标

本地JMX连接原理

当Java应用启动时，JVM会启动一个本地的JMX服务器，监听特定的端口。通过VirtualMachine.attach()方法，我们可以：

  1. 连接到指定PID的JVM进程
  2. 启动本地管理代理
  3. 获取JMX连接地址
  4. 调用进程中的MBean方法

核心实现

1. 依赖说明

JDK环境：通常不需要额外配置，tools.jar已包含在JDK中。

JRE环境：需要单独引入tools.jar依赖：

<!-- Maven -->
<dependency>
    <groupId>com.sun</groupId>
    <artifactId>tools</artifactId>
    <version>1.8.0</version>
    <scope>system</scope>
    <systemPath>${java.home}/../lib/tools.jar</systemPath>
</dependency>

// Gradle
dependencies {
    compile files("${System.getProperty('java.home')}/../lib/tools.jar")
}

Java 9+模块化：需要添加JVM参数：

--add-opens java.base/java.lang=ALL-UNNAMED
--add-opens java.base/java.lang.reflect=ALL-UNNAMED

2. 必要的JVM启动参数

目标应用需要添加以下JVM参数来启用JMX功能：

# 启用JMX远程连接（必须）
-Dcom.sun.management.jmxremote

# 启用Spring Boot JMX支持（必须）
-Dspring.jmx.enabled=true

# 暴露所有JMX端点（必须）
-Dmanagement.endpoints.jmx.exposure.include=*

可选配置（用于增强JMX功能）：

# 启用Spring应用管理MBean
# 作用：启用Spring Boot Admin MBean，提供应用配置管理功能
# 影响：此参数会创建 org.springframework.boot:type=Admin,name=SpringApplication 
# 注意：如果不启用，Spring Boot Admin MBean将不可用，它作为获取springboot实际启动端口获取的一种方式
-Dspring.application.admin.enabled=true

# 启用Spring LiveBeansView MBean
# 作用：暴露Spring容器中所有Bean的实时信息，包括Bean名称、类型、依赖关系等
# 注意：这不是JMX功能的必须配置，仅用于调试和监控Spring容器状态
-Dspring.liveBeansView.mbeanDomain

3. 核心代码实现

下面是一个简化的示例代码，展示如何通过进程PID获取Spring Boot应用的端口号：

import com.sun.tools.attach.VirtualMachine;
import org.apache.commons.lang3.StringUtils;

import javax.management.MBeanServerConnection;
import javax.management.ObjectName;
import javax.management.remote.JMXConnector;
import javax.management.remote.JMXConnectorFactory;
import javax.management.remote.JMXServiceURL;
import java.io.IOException;

/**
 * Spring Boot 端口检测器示例
 * 演示如何通过进程PID和JMX获取应用端口
 * 
 * @author 单红宇
 * @since 2025-08-10
 */
public class SpringBootPortDetector {

    /**
     * 通过进程PID获取Spring Boot应用端口
     *
     * @param pid 进程ID
     * @return 端口号，无法获取时返回null
     */
    public static Integer getPortByPid(long pid) {
        JMXConnector connector = null;
        VirtualMachine vm = null;
        try {
            // 连接到目标进程
            vm = VirtualMachine.attach(String.valueOf(pid));
            
            // 启动本地管理代理
            String jmxUrl = vm.startLocalManagementAgent();
            JMXServiceURL serviceUrl = new JMXServiceURL(jmxUrl);

            // 建立JMX连接
            connector = JMXConnectorFactory.connect(serviceUrl);
            MBeanServerConnection connection = connector.getMBeanServerConnection();
            
            // 按优先级尝试获取端口
            Object portValue = null;
            
            // 优先级1: Spring Boot Admin MBean
            ObjectName adminMBean = new ObjectName("org.springframework.boot:type=Admin,name=SpringApplication");
            if (connection.isRegistered(adminMBean)) {
                portValue = connection.invoke(adminMBean, "getProperty",
                        new Object[]{"local.server.port"}, new String[]{String.class.getName()});
            }
            
            // 优先级2: Spring Cloud Environment Manager MBean
            if (portValue == null) {
                ObjectName envMBean = new ObjectName("org.springframework.cloud.context.environment:name=environmentManager,type=EnvironmentManager");
                if (connection.isRegistered(envMBean)) {
                    portValue = connection.invoke(envMBean, "getProperty",
                            new Object[]{"local.server.port"}, new String[]{String.class.getName()});
                }
            }
            
            // 验证并返回端口值
            if (portValue != null && StringUtils.isNumeric(portValue.toString())) {
                return Integer.parseInt(portValue.toString());
            }
            
        } catch (Exception e) {
            System.err.println("获取端口失败: " + e.getMessage());
        } finally {
            // 关闭JMX连接
            if (connector != null) {
                try {
                    connector.close();
                } catch (IOException e) {
                    System.err.println("关闭JMX连接失败: " + e.getMessage());
                }
            }
            // 断开进程连接
            if (vm != null) {
                try {
                    vm.detach();
                } catch (IOException e) {
                    System.err.println("断开连接失败: " + e.getMessage());
                }
            }
        }
        return null;
    }

    /**
     * 使用示例
     */
    public static void main(String[] args) {
        if (args.length > 0) {
            try {
                long pid = Long.parseLong(args[0]);
                Integer port = getPortByPid(pid);
                if (port != null) {
                    System.out.println("进程 " + pid + " 的端口: " + port);
                } else {
                    System.out.println("无法获取进程 " + pid + " 的端口");
                }
            } catch (NumberFormatException e) {
                System.err.println("无效的进程ID: " + args[0]);
            }
        } else {
            System.out.println("用法: java SpringBootPortDetector <进程ID>");
        }
    }
}

Spring Boot MBean详解

1. Spring Boot Admin MBean

ObjectName adminMBean = new ObjectName("org.springframework.boot:type=Admin,name=SpringApplication");

这个MBean提供了Spring Boot应用的管理功能，包括：

  • 应用配置信息
  • 环境变量
  • 系统属性
  • 端口配置

重要说明：此MBean需要配置 -Dspring.application.admin.enabled=true 参数才能启用。如果不启用，org.springframework.boot:type=Admin,name=SpringApplication MBean将不会创建，导致无法通过此方式获取端口信息。

2. Spring Cloud Environment Manager MBean

ObjectName envMBean = new ObjectName("org.springframework.cloud.context.environment:name=environmentManager,type=EnvironmentManager");

这个MBean专门用于管理Spring Cloud环境配置，提供了：

  • 环境配置管理
  • 配置属性查询
  • 动态配置更新

使用场景扩展

1. 获取其他配置信息

除了端口号，我们还可以获取其他配置：

// 获取应用名称
Object appName = connection.invoke(adminMBean, "getProperty",
        new Object[]{"spring.application.name"}, new String[]{String.class.getName()});

// 获取配置文件路径
Object configPath = connection.invoke(adminMBean, "getProperty",
        new Object[]{"spring.config.location"}, new String[]{String.class.getName()});

// 获取数据库连接信息
Object dbUrl = connection.invoke(adminMBean, "getProperty",
        new Object[]{"spring.datasource.url"}, new String[]{String.class.getName()});

2. 监控应用状态

// 获取JVM内存使用情况
ObjectName memoryMBean = new ObjectName("java.lang:type=Memory");
Object heapUsage = connection.getAttribute(memoryMBean, "HeapMemoryUsage");

// 获取线程信息
ObjectName threadMBean = new ObjectName("java.lang:type=Threading");
Object threadCount = connection.getAttribute(threadMBean, "ThreadCount");

3. 动态配置更新

// 更新日志级别配置
connection.invoke(adminMBean, "setProperty",
        new Object[]{"logging.level.root", "DEBUG"}, 
        new String[]{String.class.getName(), String.class.getName()});

// 更新缓存配置
connection.invoke(adminMBean, "setProperty",
        new Object[]{"spring.cache.type", "redis"}, 
        new String[]{String.class.getName(), String.class.getName()});

注意：这样进行的环境变量修改，它只是修改了环境变量中的全局参数，部分功能你可能需要根据实际需求监听参数变化，做对应的刷新处理。

注意事项和最佳实践

1. 权限要求

  • 启动服务时候，根据不同环境注意JVM启动参数的设置

2. 性能考虑

  • VirtualMachine.attach()是重量级操作，避免频繁调用
  • 建议缓存连接，复用MBeanServerConnection
  • 及时调用detach()释放资源

3. 异常处理

JMXConnector connector = null;
VirtualMachine vm = null;
try {
    // JMX操作
    vm = VirtualMachine.attach(String.valueOf(pid));
    String jmxUrl = vm.startLocalManagementAgent();
    JMXServiceURL serviceUrl = new JMXServiceURL(jmxUrl);
    connector = JMXConnectorFactory.connect(serviceUrl);
    
    // 执行JMX操作...
    
} catch (Exception e) {
    // 记录日志，不要忽略异常
    logger.error("JMX操作失败", e);
} finally {
    // 确保资源被释放
    if (connector != null) {
        try {
            connector.close();
        } catch (IOException e) {
            logger.warn("关闭JMX连接失败", e);
        }
    }
    if (vm != null) {
        try {
            vm.detach();
        } catch (IOException e) {
            logger.warn("断开进程连接失败", e);
        }
    }
}

4. 资源管理

JMX连接器管理：

  • 使用try-with-resources或手动调用connector.close()关闭JMX连接
  • 避免长时间持有JMX连接，及时释放资源
  • 在finally块中确保连接器被正确关闭

进程连接管理：

  • 操作完成后立即调用vm.detach()断开进程连接
  • 避免重复attach同一进程，可能导致连接异常
  • 监控进程连接状态，确保资源被正确释放

连接池考虑：

  • 对于频繁的JMX操作，考虑实现连接池机制
  • 复用MBeanServerConnection，减少重复建立连接的开销
  • 设置连接超时和重试机制，提高系统稳定性

4. 兼容性考虑

  • Java 8：需要tools.jar
  • Java 9+：需要添加模块化参数
  • 不同版本的Spring Boot可能有不同的MBean结构

总结

基于进程PID的本地JMX端口检测技术提供了一种优雅、可靠的解决方案，用于获取运行中Java应用的信息。相比传统的配置文件解析和日志分析，这种方法具有以下优势：

  1. 实时性：获取的是应用运行时的实际状态
  2. 可靠性：直接从JVM内部获取数据，避免解析错误
  3. 扩展性：可以获取各种配置信息和运行时状态
  4. 标准化：基于JMX标准，具有良好的兼容性

通过本文的介绍，相信你已经掌握了这项技术的核心原理和实现方法。在实际项目中，你可以根据具体需求，扩展更多的MBean调用，实现更丰富的监控和管理功能。

参考资料

关键技术点解析

1. 进程连接（VirtualMachine.attach）

VirtualMachine vm = VirtualMachine.attach(String.valueOf(pid));

这一步是关键，它建立了与目标JVM进程的连接。VirtualMachine.attach()方法会：

  • 验证目标进程是否存在
  • 建立进程间通信通道
  • 返回VirtualMachine实例，用于后续操作

2. 启动本地管理代理

String jmxUrl = vm.startLocalManagementAgent();

startLocalManagementAgent()方法会：

  • 在目标JVM中启动JMX代理
  • 返回JMX连接地址（通常是service:jmx:rmi:///jndi/rmi://localhost:随机端口/jmxrmi）
  • 如果JMX代理已经启动，则直接返回现有地址

3. 建立JMX连接

JMXServiceURL serviceUrl = new JMXServiceURL(jmxUrl);
JMXConnector connector = JMXConnectorFactory.connect(serviceUrl);
MBeanServerConnection connection = connector.getMBeanServerConnection();

通过返回的JMX地址，建立到目标JVM的JMX连接，获取MBean服务器连接。

4. 调用MBean方法

Object portValue = connection.invoke(adminMBean, "getProperty",
        new Object[]{"server.port"}, new String[]{String.class.getName()});

使用invoke方法调用MBean中的方法：

  • 第一个参数：MBean的ObjectName
  • 第二个参数：要调用的方法名
  • 第三个参数：方法参数数组
  • 第四个参数：方法参数类型数组

5. 资源清理

finally {
    if (vm != null) {
        try {
            vm.detach();
        } catch (IOException e) {
            System.err.println("断开连接失败: " + e.getMessage());
        }
    }
}

必须调用vm.detach()断开与目标进程的连接，释放系统资源。

重要说明：虽然示例代码中使用了try-with-resources自动关闭JMX连接器，但在实际开发中，资源清理是JMX操作的关键环节：

  1. JMX连接器关闭：connector.close() 确保JMX连接被正确关闭，释放网络资源
  2. 进程连接断开：vm.detach() 断开与目标JVM的进程间通信，释放系统资源
  3. 异常安全：即使在JMX操作过程中发生异常，也要确保资源被正确释放

资源泄漏风险：

  • 未关闭的JMX连接可能导致端口占用
  • 未断开的进程连接可能影响目标JVM的正常运行
  • 长时间运行的应用可能因资源泄漏而性能下降

（END）

Zabbix5.0LTS配置Apache Kafka by JMX模板监控Kafka
L
04-27 1686
Zabbix和Kafka部署情况如下： 主机名 主机IP地址 Zabbix部署 Kafka部署 Kafka安装目录 bigdata111 192.168.128.111 Zabbix server、Zabbix agent kafka_2.11-2.1.1 /opt/kafka_2.11-2.1.1 bigdata112 192.168.128.112 Zabbix agent kafka_2.11-2.1.1 /opt/ka
【Jmeter】插件详解：PerfMon Metrics Collector 服务器性能监控插件
顾三殇 —— 博客空间（软件测试）
06-09 2047
PerfMon Metrics Collector 插件是用于监控服务器性能的 JMeter 插件，它通过收集服务器的CPU、内存、磁盘 I/O 和网络等资源使用情况的数据，帮助测试人员分析应用在不同负载下的性能表现。该插件的使用场景包括实时监控、调优测试脚本、性能瓶颈诊断等，这种插件在需要对服务器资源使用情况进行实时监控和分析的场景中扮演着重要角色。
查看java 程序占用了哪些端口
weixin_30801745的博客
08-26 289
我整理的一些关于【Java】的项目学习资料（附讲解～～）和大家一起分享、学习一下：https://d.51cto.com/f2PFnN如何查看Java程序占用了哪些端口 在Java开发过程中，很多时候需要知道程序所占用的端口，以便进行调试和测试。本文将以清晰的步骤指导您如何实现这一目标，并提供相关代码示例与解释。最后，我...
九、JVM调优工具详解及调优实战
Evan's Blog ٩(๑❛ᴗ❛๑)۶
09-18 1259
这个因为之前已经大概知道Young GC的频率，假设是每5分钟一次，那么可以执行命令 jstat -gc pid 300000 10 ，观察每次结果eden，survivor和老年代使用的变化情况，在每次gc后eden区使用一般会大幅减少，survivor和老年代都有可能增长，这些增长的对象就是每次Young GC后存活的对象，同时还可以看出每次Young GC后进去老年代大概多少对象，从而可以推算出老年代对象增长速率。尽量减少Full GC的频率，避免频繁Full GC对JVM性能的影响。
基于kafka的日志收集分析平台搭建详解
pengxb0v0的博客
09-21 770
收集前端nginx集群访问日志，统一存入kafka平台，对nginx日志做清洗，获取流量信息存入数据库。
Storm本地环境搭建详解（附实例）
u013234360的博客
09-29 2810
目的 熟悉分布式大数据流式处理的概念和常用技术； 了解开源分布式流式处理平台 Storm 的相关知识； 掌握 Linux 下的 Storm安装步骤、配置方法和运行管理。 内容 Linux环境配置； Storm 依赖包的安装、配置和运行； Storm 的安装、配置和运行； Storm-starter 实例的使用； Storm topology 的提交和管理 。 准...
1、apache-kylin-3.1.3-bin-hadoop3介绍及部署、验证详解
alanchanchn的专栏
06-22 6万+
Apache Kylin™是一个开源的、分布式的分析型数据仓库，提供 Hadoop 之上的 SQL 查询接口及多维分析（OLAP）能力以支持超大规模数据，最初由eBay Inc.开发并贡献至开源社区。Apache Kylin™ 令使用者仅需三步，即可实现超大数据集上的亚秒级查询。定义数据集上的一个星形或雪花形模型在定义的数据表上构建cube使用标准 SQL 通过 ODBC、JDBC 或 RESTFUL API 进行查询，仅需亚秒级响应时间即可获得查询结果。
18.JVM调优工具详解
最新发布
Csdn_xzh的博客
10-18 2430
JPS命令是用于列出当前系统中所有的，并显示或。默认情况下，jps命令列出Java程序的进。例如，运行jps命令可以列出当前系统中所有的Java进程及其进程ID和主函数名称。jps命令的参数及其作用。
spring boot 限制初始值大小及参数中文详解
lgxzzz的博客
09-09 1637
要加“m”说明是MB，否则就是KB了. -Xms：初始值 -Xmx：最大值 -Xmn：最小值 java -Xms10m -Xmx80m -jar mod.jar & 时区设置java -jar -Duser.timezone=GMT+08 mod.jar & ＃============================================= =========...
JVM调优工具命令详解.pdf
07-25
文档中给出了配置JMX端口的示例，这为远程监控和管理提供了可能： 1. java -Dcom.sun.management.jmxremote.port=<port> -Djava.rmi.server.hostname=<ip> -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun....
JVM内存模型和性能调优：JVM调优工具详解及调优实战：Jstack - 第37篇
悟纤学院
05-07 2万+
查看线程 一、用jstack加进程id查找死锁 用jstack加进程id查找死锁，见如下示例DeadLockTest： public class DeadLockTest { private static Object lock1 = new Object(); private static Object lock2 = new Object(); ...
httppost 302 错误，HttpPost、HttpGet关于URL重定向区别
热门推荐
小单的博客专栏
10-17 14万+
今天在做一个HttpPost请求的时候，
Java中Json字符串直接转换为对象(包括多层List集合)
小单的博客专栏
01-15 6万+
使用到的类：net.sf.json.JSONObject  下面是例子代码： // JSON转换 JSONObject jsonObj = JSONObject.fromObject(jsonStrBody); Map classMap = new HashMap(); classMap.put("results", WeatherBean
Http请求连接池 - HttpClient 的 PoolingHttpClientConnectionManager
小单的博客专栏
12-18 6万+
两个主机建立连接的过程是很复杂的一个过程，涉及到多个数据包的交换，并且也很耗时间。Http连接需要的三次握手开销很大，这一开销对于比较小的http消息来说更大。但是如果我们直接使用已经建立好的http连接，这样花费就比较小，吞吐率更大。 传统的HttpURLConnection并不支持连接池，如果要实现连接池的机制，还需要自己来管理连接对象。对于网络请求这种底层相对复杂的操作，个人以为如果有可用的
java.lang.NoClassDefFoundError: Could not initialize class sun.awt.X11.XToolkit异常解决
小单的博客专栏
10-11 5万+
该问题的解决方法：在Tomcat/bin/catalina.sh 中增加-Djava.awt.headless=true如下：JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true"原因:对于一个Java服务器来说经常要处理一些图形元素，例如地图的创建或者图形和图表等。这些API基本上总是需要运行一个X-server以便能使用AWT（Abstract Wind
Java正则表达式提取字符
小单的博客专栏
02-03 5万+
需求：提取车牌号中最后一个数字，如：宁A7865提取5，宁A876X提取6 实现方法：import java.util.regex.Matcher; import java.util.regex.Pattern;public class Test { public static void main(String[] args) { String s = "A876X";
获取网络时间（国家标准时间）
小单的博客专栏
11-27 5万+
我们在开发中，很多应用需要读取网络时间来作为一个时间的标准，对业务逻辑进行相对可靠的校验。 下面是Java中（Android一样）读取网络时间的代码：package com.test;import java.io.IOException; import java.net.MalformedURLException; import java.net.URL; import java.net.URLC
请求https错误： unable to find valid certification path to requested target
小单的博客专栏
04-14 5万+
错误及原因当Java客户端请求实现https协议的服务时，出现异常：’unable to find valid certification path to requested target’ 是因为服务期端的证书没有被认证，需要做的是把服务端证书导入到Java keystore。解决方法使用下面的类安装证书package com.shanhy.caogen; /* * Copyright 2006
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

catoop

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值