Spring Boot普通Java类托管、Bean创建及异步PDF处理报错解决

核心问题分析 #

1. 手动实例化TaggedPdfReaderToolone（带@Service注解）：Spring无法管理该实例，既会导致@Async注解失效，还会因实例依赖的PdfDocument未被注册为Bean触发错误。
2. 试图将PdfDocument注册为Bean：PdfDocument的实例与具体文件路径强绑定，属于非全局单例对象，且其构造入参String（文件路径）无法作为Spring Bean被自动注入，因此报错。

具体解决步骤 #

1. 调整TaggedPdfReaderToolone的设计 #

移除构造函数对PdfDocument的依赖，改为在异步方法内部根据文件路径动态创建PdfDocument实例，同时保留@Service和@Async注解让Spring管理该类：

@Service
public class TaggedPdfReaderToolone extends TaggedPdfReaderTool {

    @Async
    public void convertToXml(String filePath) {
        // 用try-with-resources自动关闭PdfDocument资源
        try (PdfDocument pdfDoc = new PdfDocument(new PdfReader(filePath))) {
            // 执行PDF转XML的业务逻辑
            // super.convertToXml(...) 或自定义实现
        } catch (IOException e) {
            // 异常处理逻辑，比如日志记录
            e.printStackTrace();
        }
    }
}

2. 正确注入TaggedPdfReaderToolone到Viewtag服务类 #

放弃手动实例化，通过Spring构造注入获取TaggedPdfReaderToolone的代理实例，确保@Async生效：

@Service
public class ViewtagService {

    private final TaggedPdfReaderToolone pdfReaderTool;

    // 构造注入（推荐方式）
    public ViewtagService(TaggedPdfReaderToolone pdfReaderTool) {
        this.pdfReaderTool = pdfReaderTool;
    }

    public void triggerPdfConversion(String filePath) {
        // 调用异步方法
        pdfReaderTool.convertToXml(filePath);
    }
}

3. 开启Spring异步支持 #

在项目启动类或任意@Configuration类上添加@EnableAsync注解，确保@Async注解生效：

@SpringBootApplication
@EnableAsync
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

额外说明 #

如果因父类限制必须在构造函数中传入PdfDocument，可采用原型Bean+动态参数传入的方式：

1. 注册PdfDocument为原型Bean，通过工厂方法接收文件路径：

@Configuration
public class PdfConfig {
    @Bean
    @Scope("prototype")
    public PdfDocument pdfDocument(String filePath) {
        try {
            return new PdfDocument(new PdfReader(filePath));
        } catch (IOException e) {
            throw new RuntimeException("Failed to create PdfDocument", e);
        }
    }
}

2. 在TaggedPdfReaderToolone中通过ObjectProvider动态获取原型Bean：

@Service
public class TaggedPdfReaderToolone extends TaggedPdfReaderTool {

    private final ObjectProvider<PdfDocument> pdfDocumentProvider;

    public TaggedPdfReaderToolone(ObjectProvider<PdfDocument> pdfDocumentProvider) {
        this.pdfDocumentProvider = pdfDocumentProvider;
    }

    @Async
    public void convertToXml(String filePath) {
        PdfDocument pdfDoc = pdfDocumentProvider.getObject(filePath);
        try {
            // 执行转换逻辑
        } finally {
            // 手动关闭资源（因原型Bean不会被Spring自动管理）
            try {
                pdfDoc.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

这种方式适合必须依赖构造注入的场景，但推荐优先采用第一种方法（方法内创建PdfDocument），更符合资源管理的最佳实践。

内容的提问来源于stack exchange，提问作者tejas Reddy p