手动链接依赖构建Quarkus原生镜像遇错求助

问题根源 #

jSerialComm是多平台适配的串口库，会根据运行环境自动加载对应平台的实现类。在Apple M2 Max（macOS）环境下，AndroidPort相关代码完全不需要，但GraalVM的静态分析会扫描到该类的getCommPortsNative()方法，而macOS版本的jSerialComm原生库中并没有实现这个方法，因此触发未解析元素异常。

修复方法 #

1. 排除Android平台类的静态分析

在Quarkus的Maven插件配置中添加native-image参数，强制GraalVM忽略AndroidPort类：

<plugin>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-maven-plugin</artifactId>
    <version>${quarkus.version}</version>
    <executions>
        <execution>
            <goals>
                <goal>build</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <nativeImageArgs>
            <!-- 排除Android平台类 -->
            <nativeImageArg>--exclude-class=com.fazecast.jSerialComm.android.AndroidPort</nativeImageArg>
            <!-- 允许运行时报告不支持的元素，避免构建中断 -->
            <nativeImageArg>--report-unsupported-elements-at-runtime</nativeImageArg>
        </nativeImageArgs>
    </configuration>
</plugin>

2. 强制指定macOS平台实现

通过系统属性强制jSerialComm使用macOS专属的端口实现类，避免加载Android相关代码：
在上述nativeImageArgs中新增：

<nativeImageArg>-Dcom.fazecast.jSerialComm.portProvider=com.fazecast.jSerialComm.mac.MacPort</nativeImageArg>

如果jSerialComm的原生库路径需要指定，可额外添加：

<nativeImageArg>-Djava.library.path=${project.basedir}/lib/jSerialComm/native</nativeImageArg>

（路径根据实际存放原生库的位置调整）

3. 升级jSerialComm版本

确保使用最新稳定版的jSerialComm，旧版本对GraalVM原生构建的兼容性较差。推荐使用2.10.2及以上版本：

<dependency>
    <groupId>com.fazecast</groupId>
    <artifactId>jSerialComm</artifactId>
    <version>2.10.2</version>
</dependency>

兼容性说明 #

jSerialComm本身支持GraalVM原生构建，并非完全不兼容。问题出在其多平台动态加载的机制与GraalVM静态分析的冲突，通过上述配置排除无关平台代码即可解决。

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