JNA调用本地库时结构体嵌套非Structure类报错问题排查

两种实现的核心差异 #

• 可行实现：直接在Structure子类中声明byte等JNA支持的基本类型字段。JNA对这些原生类型有明确的本地内存大小映射，能自动对齐内存布局，和C结构体的内存结构完全匹配，因此可以正常和本地库交互。
• 报错实现：将字段封装为普通Java类作为Structure子类的成员。JNA仅支持特定类型作为Structure的字段（基本类型、Structure子类、Union子类、数组等），普通类没有对应的本地内存布局定义，JNA无法计算其大小，所以抛出如下错误：

Exception in thread "main" java.lang.IllegalArgumentException: Invalid Structure field in class Install_CD97_GTML, field name 'iCardParam' (class CD97_GTML_Parameter): The type "CD97_GTML_Parameter" is not supported: Native size for type "CD97_GTML_Parameter" is unknown...

正确的C结构体/联合体映射方案 #

要准确映射你提供的C代码结构，需严格遵循JNA的类型规则：

1. 映射基础结构体 #

针对Install_CD97_GTML这类基础结构体，创建继承Structure的子类，直接声明对应字段并指定字段顺序：

import com.sun.jna.Structure;
import java.util.Arrays;
import java.util.List;

public class Install_CD97_GTML extends Structure {
    // 对应C的UCHAR类型，用byte映射
    public byte ucProtocolType;
    public byte ucAddReader;

    @Override
    protected List<String> getFieldOrder() {
        return Arrays.asList("ucProtocolType", "ucAddReader");
    }
}

同理实现Install_CD98_GTML、Install_CD99_GTML等其他基础结构体。

2. 映射联合体InstallCardParam #

JNA提供Union类专门映射C语言的联合体，所有联合体成员都声明为Union子类的字段：

import com.sun.jna.Union;
import java.util.Arrays;
import java.util.List;

public class InstallCardParam extends Union {
    public Install_CD97_GTML xCd97Param;
    public Install_CD98_GTML xCd98Param;
    public Install_CD99_GTML xCd99Param;
    // 添加其他联合体成员...

    @Override
    protected List<String> getFieldOrder() {
        return Arrays.asList("xCd97Param", "xCd98Param", "xCd99Param");
    }
}

3. 映射外层结构体InstallCard #

外层结构体包含枚举和联合体，同样继承Structure：

import com.sun.jna.Structure;
import java.util.Arrays;
import java.util.List;

// 映射C的eTypCardType枚举，用int类型承载
public interface eTypCardType {
    int CD97 = 1;
    int CD98 = 2;
    int CD99 = 3;
    // 添加其他枚举值...
}

public class InstallCard extends Structure {
    // 对应C的eTypCardType枚举，用int映射
    public int xCardType;
    // 联合体字段，JNA会自动处理其内存布局
    public InstallCardParam iCardParam;

    @Override
    protected List<String> getFieldOrder() {
        return Arrays.asList("xCardType", "iCardParam");
    }
}

4. 调用本地方法的正确姿势 #

使用联合体时，必须明确指定要使用的成员，确保JNA正确处理内存：

// 初始化外层结构体
InstallCard card = new InstallCard();
// 设置卡片类型，对应枚举值
card.xCardType = eTypCardType.CD97;
// 初始化联合体的对应成员
card.iCardParam.xCd97Param = new Install_CD97_GTML();
card.iCardParam.xCd97Param.ucProtocolType = 0x01;
card.iCardParam.xCd97Param.ucAddReader = 0x00;
// 将Java对象数据同步到本地内存
card.write();

// 调用本地方法
short result = YourNativeLibrary.sSmartInstCardEx(card);

// 如果本地库会修改结构体内容，需同步回Java对象
card.read();

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