JNA Callback返回null/空值 自定义结构体联合体映射取值异常

核心问题原因 #

• 回调参数传参约定不匹配：C头文件中回调定义为void (__stdcall *Results)( tResponse Response )，参数是按值传递的tResponse联合体；但JNA中Structure/Union类型作为回调参数时默认按引用（指针）传递，二者内存布局完全不兼容，JNA会把栈上拷贝的联合体值错当内存指针去读取，自然拿到全0/空值。
• 内部类继承关系错误：UnionResp的内部类ByReference/ByValue错误继承了不存在的TResponseU类，StructResp的内部类ByReference/ByValue错误继承了不存在的TResponseS类，导致JNA无法正确计算类型内存大小、计算字段偏移。
• 字段顺序与C定义不一致：C代码中匿名结构体头部字段顺序为iCode→iID，但Java端StructResp的@FieldOrder把iID放在第一位，所有字段内存偏移完全错位，哪怕读对内存也会拿到错误值。
• 数组成员映射规则错误：
  • 联合体中caStruct是长度16384的内联char数组，不能直接映射为String（String对应C的char*指针类型，会读取指针指向的内存地址，而非联合体内部的内联数组内容），必须映射为固定长度的byte[]。
  • 结构体末尾的caData是C99柔性数组成员，不占用结构体本身的固定内存空间，不能直接映射为String，需要手动计算内存偏移读取。
• 未指定Union激活类型：JNA的Union类型读取内存前必须调用setType()指定当前生效的成员类型，否则JNA无法按对应规则解析内存，读取结果无效。
• 回调对象存在GC回收风险：当前代码把回调实例定义为方法局部变量，方法执行完后没有强引用持有，会被JVM垃圾回收，后续触发回调时会出现内存访问崩溃，哪怕暂时能运行也属于不稳定写法。

修复步骤与代码示例 #

1. 修正回调参数类型，使用ByValue修饰的联合体类型匹配C端按值传参的约定。
2. 修正所有内部类的继承关系，ByReference/ByValue统一继承对应的外部类。
3. 严格对齐C代码的字段顺序，将固定长度内联数组映射为对应长度的byte[]，移除柔性数组成员的直接映射。
4. 回调触发时先指定Union的激活类型，手动触发内存同步后再读取字段值。
5. 将回调实例定义为类级别的成员变量，持有强引用避免被GC回收。

修正后的结构体映射代码 #

@Structure.FieldOrder({"uResp"})
public class TResponse extends Structure {
    public static class ByReference extends TResponse implements Structure.ByReference { }
    public static class ByValue extends TResponse implements Structure.ByValue { }
    
    public UnionResp uResp;

    public static class UnionResp extends Union {
        // 修正继承类为当前外部类
        public static class ByReference extends UnionResp implements Union.ByReference { }
        public static class ByValue extends UnionResp implements Union.ByValue { }

        // 固定长度内联数组映射为对应长度的byte数组
        public byte[] caStruct = new byte[16384];
        public StructResp sResp;
    }

    // 字段顺序严格和C定义对齐，移除柔性数组caData的直接映射
    @Structure.FieldOrder({"iCode","iID","iResult","iInfo","iNum","iMask","iaReserve"})
    public static class StructResp extends Structure {
        // 修正继承类为当前外部类
        public static class ByReference extends StructResp implements Structure.ByReference { }
        public static class ByValue extends StructResp implements Structure.ByValue { }

        public int  iCode;
        public int  iID;
        public int  iResult;
        public int  iInfo;
        public int  iNum;
        public int  iMask;
        public int[] iaReserve = new int[10];

        // 柔性数组caData读取方式：结构体头部总长度为16个int = 64字节
        // 调用getPointer().getByteArray(64, 实际数据长度)即可读取payload内容
    }
}

修正后的DLL接口定义 #

public interface JNAVIsiWheAi extends Library {
    JNAVIsiWheAi INSTANCE = Native.load("C:\\CWM\\JNAVIsiWheAi.dll", JNAVIsiWheAi.class);
    
    interface Results extends Callback{
        // 参数必须使用ByValue类型，匹配C端按值传参的约定
        void invoke(TResponse.ByValue tRes);
    }

    int vwacom_ResultCallback(Results results);
}

修正后的回调使用代码 #

// 把回调实例定义为类成员变量，持有强引用避免GC回收
private JNAVIsiWheAi.Results results;

public void resultCallback() {
    results = new JNAVIsiWheAi.Results() {
        @Override
        public void invoke(TResponse.ByValue tRes) {
            // 先指定Union当前激活的类型为结构体sResp
            tRes.uResp.setType(TResponse.UnionResp.StructResp.class);
            TResponse.StructResp resp = tRes.uResp.sResp;
            // 手动触发read，确保 native 内存数据同步到Java字段
            resp.read();

            // 正常读取头部字段
            System.out.println("iCode: " + resp.iCode);
            System.out.println("iID: " + resp.iID);
            System.out.println("iResult: " + resp.iResult);
            // 其余头部字段按相同方式读取

            // 读取柔性数组caData示例，实际长度根据iInfo、iNum字段计算
            // int payloadLen = resp.iNum * 单条数据长度;
            // byte[] caData = resp.getPointer().getByteArray(64, payloadLen);
        }
    };

    jnavIsiWheAi.vwacom_ResultCallback(results);
}

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