【2023】Java利用modbus4j实现工业设备Modbus TCP数据采集与解析

1. 从零开始：为什么选择Java和modbus4j？

如果你正在接触工业物联网或者智能制造项目，十有八九会遇到一个叫Modbus的协议。它就像工业设备之间的“普通话”，让PLC、传感器、变频器这些不同厂家的硬件能互相听懂对方在说什么。而我们要做的，就是用Java程序扮演一个“翻译官”（主站/Master），去主动询问设备（从站/Slave）：“你现在的温度是多少？”、“电机开关状态怎么样？”，并把结果拿回来处理。

为什么用Java？因为Java生态成熟，跨平台，在企业级应用里扎根深，特别适合构建需要长期稳定运行的数据采集服务器。那为什么是modbus4j这个库？我踩过不少坑，试过好几个Java的Modbus库，最后发现modbus4j在易用性和功能完整性上平衡得最好。它封装了底层复杂的报文拼装和解析，你不需要去死磕Modbus TCP那几十个字节的报文格式，用几行代码就能完成读写操作。而且它支持的功能码很全，从基本的线圈读写到复杂的批量寄存器操作都没问题。

我印象很深的一个项目，需要同时采集一条产线上几十台设备的几百个数据点。最早用同步Socket自己写，经常遇到连接阻塞，数据延迟高。后来换到modbus4j，利用它内置的连接管理和超时重试机制，稳定性一下子就上来了。所以，无论你是要做简单的设备监控，还是复杂的MES（制造执行系统）数据集成，用Java + modbus4j这个组合，都能让你事半功倍。

2. 5分钟快速搭建你的开发环境

工欲善其事，必先利其器。在写代码之前，咱们得先把“战场”布置好。这里我会带你走一遍我每次开始新项目时的标准流程，保证你一次搞定，避开我当年遇到的坑。

2.1 搞定依赖：Maven仓库的“小陷阱”

modbus4j的官方仓库不在主流的Maven中央仓库里，所以如果你在pom.xml里只写依赖，然后用阿里云镜像，百分之百会下载失败。这是我遇到的第一个坑。正确的做法是，在项目的pom.xml里，需要明确添加它的两个专属仓库地址。

<!-- 在你的 pom.xml 文件中添加以下仓库配置 -->
<repositories>
    <repository>
        <releases>
            <enabled>false</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
        <id>ias-snapshots</id>
        <name>Infinite Automation Snapshot Repository</name>
        <url>https://maven.mangoautomation.net/repository/ias-snapshot/</url>
    </repository>
    <repository>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
        <id>ias-releases</id>
        <name>Infinite Automation Release Repository</name>
        <url>https://maven.mangoautomation.net/repository/ias-release/</url>
    </repository>
</repositories>

<!-- 然后添加依赖 -->
<dependencies>
    <dependency>
        <groupId>com.infiniteautomation</groupId>
        <artifactId>modbus4j</artifactId>
        <version>3.0.3</version>
    </dependency>
    <!-- 建议也加上这个，工具类好用 -->
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-lang3</artifactId>
        <version>3.12.0</version>
    </dependency>
</dependencies>

配置好后，在IDE里刷新一下Maven项目，看到modbus4j-3.0.3.jar成功引入，第一步就稳了。如果网络慢，多等一会儿，或者检查一下是不是有旧的错误配置没删干净。

2.2 没有硬件？用仿真软件模拟一个从站

刚开始学，手头不一定有真实的PLC或仪表。完全没关系，我们可以用仿真软件来模拟一个设备从站。我强烈推荐Modbus Slave这款软件，它小巧灵活，可以模拟出各种数据响应。

安装好后，你需要创建一个TCP从站。点击菜单栏的Connection -> Connect...，在弹出窗口中选择连接类型为Modbus TCP/IP，然后设置一个IP和端口，比如127.0.0.1:502。接着，你需要定义数据区。软件里按F8键，可以打开定义窗口。这里就是模拟设备存储数据的地方，Modbus协议里主要分四种：

在仿真软件里，你可以分别新建四个窗口，对应这四种功能码。在每个窗口里，设置起始地址（比如从0开始）和数量（比如10个）。然后你就可以手动双击某个地址，修改它的值，比如把地址0的线圈改成True，把地址1的保持寄存器值改成1234。这样，一个虚拟的、会“说话”的设备就准备好了，等着我们的Java程序来连接和读写。

3. 核心实战：建立TCP连接与基础数据读取

环境搭好，模拟设备就绪，现在可以动手写代码了。咱们先从最简单的开始——建立TCP连接，然后读取一两个数据看看。

3.1 创建Modbus TCP主站连接

在modbus4j里，一切操作的起点是ModbusFactory和ModbusMaster。ModbusFactory是个工厂类，专门用来生产各种协议（TCP、RTU等）的主站对象。ModbusMaster就是你跟设备对话的“话筒”。

下面这个getMaster方法是我项目中常用的连接创建方法，