Vertx应用构建Fat Jar后运行抛出异常，本地直接运行正常

这个问题大概率和Vert.x自动生成的线程无关，反而更可能出在Maven Shade插件的打包配置或者你的代码线程安全问题上，我来给你拆解下：

可能的原因分析 #

1. Maven Shade插件的资源合并冲突 #

你用的是maven-shade-plugin 2.3版本，这个版本比较老旧，在处理Vert.x依赖中的SPI配置文件（比如META-INF/services目录下的文件）时，默认会直接覆盖而不是合并。Vert.x的很多组件依赖这些SPI文件来加载扩展类，一旦文件被覆盖，运行时就会出现类加载异常，这种异常有时候会表现为随机的ArrayIndexOutOfBoundsException（因为类加载失败导致后续逻辑混乱）。

2. 代码中的线程不安全操作 #

虽然在IntelliJ直接运行时正常，但Fat Jar的类加载环境和IDE运行环境有差异，可能会让代码中隐藏的线程不安全问题暴露出来。比如你在Vert.x的事件循环线程或Worker线程中使用了非线程安全的集合（如ArrayList、HashMap），并发修改时就可能触发ArrayIndexOutOfBoundsException——IDE运行时可能并发压力小，问题没显现，打包后运行场景下并发更明显就触发了。

解决方案 #

修复Maven Shade插件配置 #

首先升级插件版本并添加SPI文件合并的Transformer，这是最常见的解决方法：

1. 把maven-shade-plugin的版本升级到最新稳定版（比如3.5.1）
2. 在transformers节点中添加ServicesResourceTransformer来合并SPI文件

修改后的pom.xml构建配置示例：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <!-- 升级到稳定新版本 -->
            <version>3.5.1</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <manifestEntries>
                                    <Main-Class>io.vertx.core.Launcher</Main-Class>
                                    <Main-Verticle>App</Main-Verticle>
                                </manifestEntries>
                            </transformer>
                            <!-- 添加这个Transformer合并SPI文件 -->
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                        </transformers>
                        <artifactSet/>
                        <outputFile>${project.build.directory}/${project.artifactId}-${project.version}-fat.jar</outputFile>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

排查代码中的线程安全问题 #

如果修改插件配置后问题仍然存在，就需要定位具体的异常位置：

• 打印完整的异常堆栈跟踪，找到抛出ArrayIndexOutOfBoundsException的具体代码行
• 检查该行是否使用了非线程安全的集合，比如在多线程环境下修改ArrayList
• 替换为线程安全的集合（如CopyOnWriteArrayList、ConcurrentHashMap），或者在修改操作时添加同步锁
• 严格遵循Vert.x的线程模型：不要在事件循环线程中执行阻塞操作，Worker线程的共享资源操作必须保证线程安全

验证步骤 #

1. 先修改Shade插件配置，执行mvn clean package重新打包，运行Fat Jar看异常是否消失
2. 如果问题依旧，根据异常堆栈定位代码中的线程不安全点，针对性修复

内容的提问来源于stack exchange，提问作者Meet Shah