IntelliJ自动补全不识别Java native方法参数名问题咨询

1. 调整编译脚本执行顺序 #

当前脚本先执行cmake的顺序完全错误，JNI项目正确的编译链路必须严格按以下顺序执行：

• 先执行javac编译所有Java层代码，命令中必须添加-h <JNI头文件输出目录>参数，编译Java类的同时直接生成对应最新版本的JNI头文件，替代旧版本JDK中独立的javah工具
• 再执行cmake/make编译C原生库、JNI封装层，输出对应平台的动态库文件（Linux为.so、Windows为.dll、Mac为.dylib），这一步编译时直接引用上一步生成的最新头文件，从根源上避免Java声明和C实现的签名不一致问题
• 最后将编译产出的.class文件、动态库文件按规范目录结构打包到最终jar包

注意：动态库放入jar包时必须按平台规则放置在对应资源目录下，例如Linux x86_64架构的so文件需要放在/linux-x86-64/路径下，否则运行时无法正常加载。

2. 补全javac编译参数 #

仅添加-g参数无法满足native方法的调试信息保留需求：

• -g生成的调试信息仅包含行号、源文件引用、非native方法的局部变量表，而native方法没有Java实现的方法体，不存在局部变量表结构，因此无法通过该参数留存参数信息
• 必须额外添加-parameters编译参数（JDK8及以上版本支持），该参数会将方法的形式参数名、参数类型签名写入class文件的MethodParameters属性段，无论方法是否带native修饰都会生效，IntelliJ等IDE读取class时会直接解析该段内容展示参数提示。

如果需要兼容JDK8以下版本，无法使用-parameters参数，可以在发布主jar包时同步发布同名sources.jar源码包，IDE会自动关联源码提取参数信息完成提示。

3. 修复验证 #

编译完成后执行javap -verbose <类全限定名>命令反编译class文件，找到对应native方法的定义段，如果能看到MethodParameters块下列出了所有参数的名称、类型，就说明元数据已经正确写入，IDE重启/重新索引后即可展示正常的代码提示。

1. 你遇到的class文件无法展示方法参数提示的问题，本质是class文件方法参数元数据缺失，检索相关问题可以使用关键词：javac native method parameter name missing、MethodParameters attribute not generated for native methods
2. 如果Java层native声明和C++层实现的签名、参数类型不匹配，运行时抛出链接错误的问题，专业术语为JNI符号不匹配（JNI Symbol Mismatch），对应抛出的运行时异常为java.lang.UnsatisfiedLinkError。

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