SpringBoot整合OpenCV报Illegal reflective access警告的解决方法

问题根因 #

你遇到的非法反射访问警告和Maven插件配置没有任何关系，加compiler、war插件解决不了问题。警告来源是你引入的org.openpnp:opencv:4.5.1-2包的本地库加载逻辑：它通过反射访问JDK中ClassLoader类的私有字段usr_paths，这个操作在Java 9及以上版本受模块访问限制，就会抛出该警告。你虽然在pom中指定了编译版本为1.8，但实际运行程序用的是9+版本的JDK，才会出现这个提示。

现有配置的错误 #

• 插件配置位置错误：maven-compiler-plugin、maven-war-plugin是Maven构建插件，不属于普通项目依赖，你把两个插件放到<dependencies>标签下是无效写法。这两个插件应当配置在<build><plugins>节点下，且Spring Boot 2.7.0的父POM已经默认集成了适配版本的编译插件，不需要手动引入；war插件仅在需要将项目打包为war包部署到外部Servlet容器时才需要使用，普通jar包运行场景不需要配置。
• 本地库重复加载：调用nu.pattern.OpenCV.loadShared()后，openpnp的封装逻辑已经完成了OpenCV原生库的加载，不需要再额外执行System.loadLibrary(org.opencv.core.Core.NATIVE_LIBRARY_NAME)，重复调用容易触发库加载冲突。
• 加载时机错误：你把OpenCV加载逻辑写在SpringApplication.run()执行之后，如果Spring容器启动过程中有Bean提前依赖OpenCV相关类，会直接触发原生库找不到的错误，根本执行不到后面的加载代码，这也是你跑参考示例只有警告没有正常输出的核心原因。

警告修复方案 #

根据你使用的JDK版本二选一处理即可：

• 如果你使用JDK8运行项目：直接将IDE、Maven的运行时环境切换为JDK1.8，警告会直接消失，JDK8没有模块访问限制，允许该反射操作正常执行。
• 如果你需要使用JDK9及以上版本（JDK11、JDK17等）：
  • 优先升级openpnp的OpenCV包版本到4.7.0-0及以上，新版本已经修复了高版本JDK下的反射访问问题，不会再触发该警告。
  • 暂时无法升级依赖的话，给JVM添加启动参数--add-opens java.base/java.lang=ALL-UNNAMED，放开对应模块的反射访问权限即可消除警告，该参数在JDK17及之前版本均有效。

正确入门使用说明 #

1. 修正pom配置：删除dependencies节点下的maven-compiler-plugin、maven-war-plugin两个无效依赖，如果不需要打war包，build节点下仅保留spring-boot-maven-plugin即可。
2. 调整加载时机：在SpringApplication.run()执行前就调用nu.pattern.OpenCV.loadShared()完成原生库加载，避免启动过程中类加载失败。
3. 去掉重复的System.loadLibrary调用，仅保留openpnp提供的加载方法即可。

补充说明：该警告本身不会影响OpenCV在JDK8-JDK16版本上的正常运行，仅为高版本JDK的兼容性提示；JDK17及以后版本如果不做上述处理，会直接拦截反射操作导致原生库加载失败。

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