如何在Java库中正确指定jar包内资源文件的访问路径？

问题根因 #

你遇到的两个报错本质都是Jar包内资源无法用普通文件系统路径直接访问导致的：

• 功能在主项目中时，资源是存放在解压后的classes目录下，属于本地文件系统可直接读取的路径，访问逻辑正常。拆分到独立Jar之后，资源是打包在Jar包内部的，路径中的!/是Jar包资源的特殊分隔符，普通文件IO接口无法识别该格式路径，所以会抛出文件找不到异常。
• Thymeleaf默认只会扫描当前启动项目的模板路径，不会主动加载依赖Jar包内的模板文件，因此会报视图无法解析的错误。

解决方案 #

1. 修复OpenPDF读取Jar内图片的问题 #

不要传入本地文件路径给Image.getInstance，改用类加载器读取Jar内资源的输入流来构造Image对象，代码示例如下：

import com.lowagie.text.Image;
import java.io.InputStream;

// 非静态方法中使用
try (InputStream is = getClass().getResourceAsStream("/img/image.jpeg")) {
    if (is == null) {
        throw new RuntimeException("未找到Jar内资源/img/image.jpeg，请检查资源存放路径");
    }
    // 读取为字节数组后构造Image
    byte[] imgBytes = is.readAllBytes();
    Image image = Image.getInstance(imgBytes);
} catch (Exception e) {
    e.printStackTrace();
}

注意：如果是静态方法中调用，把getClass()替换为你的当前类名.class即可；资源路径开头的/代表从Jar的类路径根目录开始查找，需要确保你的图片存放在库项目的src/main/resources/img/目录下，打包后才会出现在Jar的对应路径中。

2. 修复Thymeleaf加载Jar内模板的问题 #

在你的自定义库中新增Thymeleaf配置类，注册支持扫描Jar内模板的解析器即可，代码示例如下：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.thymeleaf.spring6.SpringTemplateEngine;
import org.thymeleaf.spring6.templateresolver.SpringResourceTemplateResolver;
import org.thymeleaf.templatemode.TemplateMode;

@Configuration
public class CustomLibThymeleafConfig {

    @Bean
    public SpringResourceTemplateResolver libTemplateResolver() {
        SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();
        // 前缀配置为你Jar内模板存放的路径，示例对应库项目中src/main/resources/custom-lib/templates/目录
        resolver.setPrefix("classpath:/custom-lib/templates/");
        resolver.setSuffix(".html");
        resolver.setTemplateMode(TemplateMode.HTML);
        resolver.setCharacterEncoding("UTF-8");
        // 设置优先级高于项目默认的模板解析器
        resolver.setOrder(1);
        resolver.setCheckExistence(true);
        return resolver;
    }
}

注意：如果你的库是Spring Boot自动装配的，需要把该配置类的全限定名添加到库的META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件中，引入依赖的项目启动时会自动加载该配置，无需额外手动扫描；Spring 5版本仅需调整对应导入的包名，配置逻辑完全一致。

内容的提问来源于stack exchange，提问作者nikiforov.java