JasperReports Studio使用自定义Java类抛出ClassNotFoundException求助

解决JasperReports Studio 6.17无法识别自定义Java类问题 #

核心原因 #

JasperReports Studio (JSS) 预览报表时使用独立的类加载器，和你配置的Java项目Build Path不互通，这是该问题的根本诱因。

操作步骤 #

• 第一步：导出自定义类Jar包
  将你编写的Scriptlett、自定义工具类相关代码，连同依赖的Jar包一起导出为标准Jar文件，注意编译JDK版本要和JSS 6.17默认的JDK 11兼容，不要使用更高版本JDK编译，避免版本不兼容问题。
• 第二步：将Jar包添加到JSS类加载路径
  二选一即可，推荐优先用项目级配置：
  • 项目级配置：在左侧「Project Explorer」右键你的报表项目，选择「Properties」，依次进入「Jaspersoft Studio」→「Classpath」选项卡，点击「Add JARs」选择刚才导出的Jar包，保存后重启JSS生效。
  • 全局配置：需要所有项目共用该Jar包时，打开顶部菜单「Window」→「Preferences」，依次进入「Jaspersoft Studio」→「Classpath」，添加Jar包后重启即可。
• 第三步：检查jrxml模板声明规范
  • 使用自定义Scriptlett时，要在<jasperReport>根节点配置全限定类名：
    scriptletClass="com.yourpackage.YourCustomScriptlet"
  • 表达式中调用自定义类方法时，也必须写全限定类名，示例：
    com.yourpackage.YourUtils.formatStr($F{field_name})
• 第四步：缓存清理（如果配置后仍报错）
  关闭JSS，删除工作空间目录下的.metadata/.plugins/net.sf.jasperreports.studio文件夹，重启JSS后重新预览即可。

如果你是部署到外部Java程序运行时报错，只需确认自定义类Jar包已经放入外部程序的运行类路径即可。

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