Java使用Aspose.PDF for Java实现PDF转Word无水印无页数限制

<properties>
    <aspose.pdf.version>25.3</aspose.pdf.version>
</properties>
<repositories>
    <repository>
        <id>aspose-repo</id>
        <name>Aspose Java API Repository</name>
        <url>https://releases.aspose.com/java/repo/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-pdf</artifactId>
        <version>${aspose.pdf.version}</version>
    </dependency>
</dependencies>

@Component
public class AsposeLicenseConfig {
    @PostConstruct
    public void init() {
        try {
            License license = new License();
            // 从 classpath 加载 license 文件
            InputStream is = getClass()
                .getClassLoader()
                .getResourceAsStream("license/Aspose.PDF.lic");
            if (is != null) {
                license.setLicense(is);
                log.info("Aspose.PDF License 加载成功");
            } else {
                log.warn("未找到 Aspose.PDF License 文件，将使用评估模式（有水印）");
            }
        } catch (Exception e) {
            log.error("Aspose.PDF License 加载失败", e);
        }
    }
}

@Component
public class AsposeMeteredLicenseConfig {

    @PostConstruct
    public void init() {
        try {
            Metered metered = new Metered();
            // 使用你在 Aspose 官网申请的公钥和私钥
            metered.setMeteredKey(
                "你的公钥-public-key",
                "你的私钥-private-key"
            );
            log.info("Aspose.PDF Metered License 加载成功");
        } catch (Exception e) {
            log.error("Metered License 加载失败", e);
        }
    }
}

@Service
@Slf4j
public class PdfToWordService {

    /**
     * PDF 转 Word（DOCX）
     *
     * @param pdfFilePath  输入 PDF 文件路径
     * @param outputDir    输出目录
     * @return 转换后的 DOCX 文件路径
     */
    public String convertPdfToWord(String pdfFilePath, String outputDir) {
        long startTime = System.currentTimeMillis();

        try {
            // 1. 加载 PDF 文档
            Document pdfDocument = new Document(pdfFilePath);

            // 2. 设置转换参数（优化转换质量）
            DocSaveOptions saveOptions = new DocSaveOptions();
            saveOptions.setFormat(DocSaveOptions.DocFormat.DocX);
            // 识别列表/表格结构（提升排版还原度）
            saveOptions.setRecognizeListItems(true);
            // 相对对齐优化
            saveOptions.setRelativeHorizontalProximity(2.5f);
            // 模式：增强排版还原
            saveOptions.setMode(DocSaveOptions.RecognitionMode.TextBoxFlow);

            // 3. 生成输出文件名
            String fileName = FilenameUtils.getBaseName(pdfFilePath) + ".docx";
            String outputPath = outputDir + File.separator + fileName;

            // 4. 执行转换
            pdfDocument.save(outputPath, saveOptions);
            pdfDocument.close();

            long cost = System.currentTimeMillis() - startTime;
            log.info("PDF转Word完成，耗时: {}ms，文件: {}", cost, outputPath);

            return outputPath;

        } catch (Exception e) {
            log.error("PDF转Word失败，文件: {}", pdfFilePath, e);
            throw new RuntimeException("PDF转Word转换失败: " + e.getMessage());
        }
    }
}

/**
 * 根据不同 PDF 类型选择最优转换策略
 */
public String convertWithStrategy(String pdfFilePath, String outputDir, ConvertStrategy strategy) {
    Document pdfDocument = new Document(pdfFilePath);
    DocSaveOptions saveOptions = new DocSaveOptions();
    saveOptions.setFormat(DocSaveOptions.DocFormat.DocX);

    switch (strategy) {
        case HIGH_FIDELITY:
            // 高保真模式：最大程度还原排版（适合复杂排版的 PDF）
            saveOptions.setMode(DocSaveOptions.RecognitionMode.TextBoxFlow);
            saveOptions.setRecognizeListItems(true);
            saveOptions.setRelativeHorizontalProximity(2.5f);
            break;

        case TEXT_FOCUS:
            // 文本优先模式：牺牲部分排版，提升文本提取准确度（适合扫描件）
            saveOptions.setMode(DocSaveOptions.RecognitionMode.PureTextBox);
            break;

        case FAST:
            // 快速模式：转换速度最快（适合简单 PDF）
            saveOptions.setMode(DocSaveOptions.RecognitionMode.TextBoxFlow);
            saveOptions.setRecognizeListItems(false);
            break;

        default:
            saveOptions.setMode(DocSaveOptions.RecognitionMode.TextBoxFlow);
    }

    String outputPath = outputDir + File.separator 
        + FilenameUtils.getBaseName(pdfFilePath) + ".docx";
    pdfDocument.save(outputPath, saveOptions);
    pdfDocument.close();
    return outputPath;
}

public enum ConvertStrategy {
    HIGH_FIDELITY,  // 高保真（默认推荐）
    TEXT_FOCUS,     // 文本优先
    FAST            // 快速转换
}

@RestController
@RequestMapping("/api/convert")
@Slf4j
public class ConvertController {

    @Autowired
    private PdfToWordService pdfToWordService;

    @Autowired
    private FileStorageService fileStorageService;

    /**
     * PDF 转 Word 接口
     */
    @PostMapping("/pdf-to-word")
    public Result<ConvertResultVO> convertPdfToWord(
            @RequestParam("file") MultipartFile file,
            @RequestParam(value = "strategy", defaultValue = "HIGH_FIDELITY") ConvertStrategy strategy) {

        // 1. 校验文件
        if (file.isEmpty()) {
            return Result.fail("文件不能为空");
        }
        String originalName = file.getOriginalFilename();
        if (!originalName.toLowerCase().endsWith(".pdf")) {
            return Result.fail("仅支持 PDF 格式文件");
        }

        // 2. 保存上传文件到临时目录
        String pdfFilePath = fileStorageService.saveTempFile(file);

        try {
            // 3. 执行转换
            String outputDir = fileStorageService.getTempOutputDir();
            String docxFilePath = pdfToWordService.convertWithStrategy(
                pdfFilePath, outputDir, strategy);

            // 4. 获取文件大小信息
            File pdfFile = new File(pdfFilePath);
            File docxFile = new File(docxFilePath);

            ConvertResultVO result = new ConvertResultVO();
            result.setOutputFileName(FilenameUtils.getName(docxFilePath));
            result.setOutputFileSize(docxFile.length());
            result.setInputFileSize(pdfFile.length());
            result.setOutputUrl("/files/download/" + FilenameUtils.getName(docxFilePath));

            return Result.success(result);

        } finally {
            // 5. 清理临时 PDF 文件（转换结果保留 48 小时后自动清理）
            fileStorageService.scheduleDelete(pdfFilePath, 48);
        }
    }
}

场景：非会员每日 3 次免费，假设 DAU = 1000

日转换量 ≈ 1000 × 3 = 3,000 次/天
月转换量 ≈ 90,000 次/月

Metered License 成本 ≈ 90,000 × $0.02 ≈ $1,800/月（约 ¥13,000/月）
永久授权成本 ≈ $1,199 + $399/年 ≈ ¥11,500 首年（无限次）

┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
│  微信小程序   │────▶│  SpringBoot 后端  │────▶│   MinIO     │
│  (文件上传)   │     │  Aspose.PDF 转换  │     │ (文件存储)   │
└─────────────┘     └──────────────────┘     └─────────────┘
                           │
                    ┌──────┴──────┐
                    │  MySQL      │
                    │  (记录/用户)  │
                    └─────────────┘