如何将CometD 5.x及以上版本jar包引入Maven项目

首先明确：CometD 5.x及以上版本对代码做了细粒度模块化拆分，你在Maven中央仓库看到cometd-java-client仅包含POM文件不是上传遗漏，该坐标本身是聚合用的父POM，不包含可执行代码，直接依赖该坐标自然无法获取Jar包。
如果已经下载了官网提供的全量依赖tar.gz压缩包，以下两种方案操作成本远低于手动逐个添加Jar到类路径。

方案一：直接将解压后的压缩包配置为本地文件仓库（推荐，操作最少） #

这个方案不需要手动安装任何Jar到本地Maven仓库，也不需要修改Maven全局配置，仅需调整项目pom.xml即可：

• 第一步：将下载的tar.gz压缩包解压到本地固定存储目录，解压后目录结构和标准Maven仓库完全一致，根目录下可直接看到org/cometd/java层级的文件夹，不需要额外调整目录结构。
• 第二步：在项目pom.xml中添加本地仓库配置，指向解压后的目录绝对路径：

<repositories>
    <repository>
        <id>cometd-local-bundle</id>
        <!-- 替换为你自己的解压路径 -->
        <!-- Windows路径示例：file:///D:/dev-libs/cometd-7.0.7 -->
        <!-- Linux/macOS路径示例：file:///home/yourname/dev-libs/cometd-7.0.7 -->
        <url>file:///你的CometD压缩包解压绝对路径</url>
    </repository>
</repositories>

• 第三步：替换原有的cometd-java-client依赖，按需引入实际的客户端模块，常用基础客户端依赖配置如下：

<dependencies>
    <!-- 客户端核心API -->
    <dependency>
        <groupId>org.cometd.java</groupId>
        <artifactId>cometd-java-client-api</artifactId>
        <version>7.0.7</version>
    </dependency>
    <!-- JDK 11+ 内置HttpClient实现，无额外第三方依赖，HTTP连接场景选这个 -->
    <dependency>
        <groupId>org.cometd.java</groupId>
        <artifactId>cometd-java-client-http-jdk</artifactId>
        <version>7.0.7</version>
    </dependency>
    <!-- JDK 11+ 内置WebSocket实现，需要WebSocket长连接场景加这个 -->
    <dependency>
        <groupId>org.cometd.java</groupId>
        <artifactId>cometd-java-client-websocket-jdk</artifactId>
        <version>7.0.7</version>
    </dependency>
    <!-- 如果你使用JDK8，替换上面两个jdk后缀的实现包为okhttp或jetty适配的版本即可，解压目录内可直接找到对应artifactId的文件夹 -->
</dependencies>

• 第四步：执行mvn compile命令验证依赖加载正常即可，Maven会直接从你配置的本地文件路径拉取对应Jar和POM文件，不需要额外操作。

方案二：批量导入依赖到本地默认Maven仓库（适合多项目复用） #

如果需要在本机多个项目中复用该版本CometD依赖，不需要每个项目都配置本地仓库路径，可直接将解压后根目录下的org文件夹，整个复制到本地Maven默认仓库路径（一般为用户目录下的.m2/repository/文件夹），覆盖同名目录即可。
复制完成后，不需要在pom.xml中添加额外的repository配置，直接引入对应模块依赖即可正常使用，全程不需要执行任何maven install命令。

避坑说明 #

• 不要使用system scope手动指定Jar路径配置依赖，该方式会导致后续打包、版本升级、依赖传递出现大量兼容问题，不符合Maven依赖管理规范。
• 不需要引入服务端相关的依赖包，仅引入上述客户端模块即可满足命令行客户端的运行需求，不会引入多余的冗余依赖。
• 如果需要使用OkHttp、Jetty等其他底层HTTP/WebSocket实现，直接替换对应实现包的artifactId即可，所有可用包都可以在解压目录的org/cometd/java路径下找到。

内容的提问来源于stack exchange，提问作者Marco Luglio