Spring Boot+Thymeleaf项目：如何让API2PDF读取Tailwind CSS样式？

核心原因 #

API2PDF服务无法解析Thymeleaf的@{}语法生成的相对路径，同时外部服务无法直接访问你本地环境的静态资源文件，导致样式加载失败。

可行解决方案 #

1. 内联CSS到HTML文件 #

直接将Tailwind编译后的main.css全部内容嵌入HTML的<style>标签中，让API2PDF解析HTML时能直接读取到样式：

<style type="text/css">
/* 粘贴编译后的main.css全部内容 */
</style>

如果CSS体积较大，建议先使用压缩工具处理后再嵌入，避免HTML文件过大影响转换效率。

2. 提供CSS的公开可访问绝对URL #

将编译好的main.css部署到可被外部访问的环境（比如你的Spring Boot生产服务器静态资源目录），然后用绝对路径替换相对路径引用：

<link rel="stylesheet" type="text/css" href="https://你的服务器域名/css/main.css" />

替换后先在浏览器中直接访问该URL，确认能正常加载CSS内容，再传给API2PDF服务。

3. 配置Spring Boot静态资源跨域（若需跨域访问） #

如果API2PDF服务访问你的服务器CSS资源时出现跨域限制，可在Spring Boot中添加跨域配置：

@Configuration
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/css/**")
                .allowedOrigins("*") // 也可指定API2PDF的服务域名提升安全性
                .allowedMethods("GET");
    }
}

4. 使用Tailwind JIT模式生成按需CSS #

开启Tailwind的JIT模式，仅生成当前HTML页面实际用到的样式，减小CSS体积后再选择内联或部署，既降低API2PDF的解析压力，也能避免冗余代码。

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