fix: 修复 Office 文件先 PDF 预览再切换图片预览时提示缓存异常

[yuhaibohotmail]

问题

Office 文件（docx、pptx 等）先用 PDF 方式预览，再点「使用图片预览」（或直接带 officePreviewType=image 打开同一个文件），页面提示：

Office转换缓存异常，请联系管理员

同一个文件如果一开始就用图片方式预览则正常。在当前 master（即 5.0.3）上用下面的单元测试可以稳定复现，现象与 #754 一致。

原因

OfficeFilePreviewImpl#filePreviewHandle 里，PDF 预览与图片预览共用同一个 cacheName（转换出的 PDF 文件名）：

• PDF 预览（handleRegularOfficePreview）转换完成后调用 fileHandlerService.addConvertedFile(cacheName, ...)，此时只有 PDF，图片还没有生成；
• 图片预览分支判断是否需要转换时只看 fileHandlerService.listConvertedFiles().containsKey(cacheName)。上一步已经把 cacheName 记进去了，于是走到「已有缓存，直接渲染」，进入 getPreviewType；
• getPreviewType 调 fileHandlerService.loadPdf2jpgCache(outFilePath) 取图片列表，取到空列表，返回「Office转换缓存异常，请联系管理员」。

PdfFilePreviewImpl 没有这个问题，因为它的 cacheName 是 pdfName + officePreviewType，两种预览方式各用各的缓存名。

修复

图片预览分支判断是否需要转换时，增加「图片缓存是否存在」这一条件：

if (forceUpdatedCache || !fileHandlerService.listConvertedFiles().containsKey(cacheName) || !ConfigConstants.isCacheEnabled()
        || !hasImageCache(outFilePath)) {

hasImageCache 与 getPreviewType 取图片的两个来源保持一致：加密文档的图片缓存（pdftojpgservice.hasEncryptedPdfCacheSimple）或普通图片缓存（fileHandlerService.loadPdf2jpgCache）有一个存在就算有。都没有时按未转换处理，走原有的异步转换流程并返回等待页；转换完成后再次进入就直接渲染图片。

只改了这一个判断，没有改 cacheName 的生成方式，已有的缓存不受影响；PDF 预览分支没有改动。

验证

新增 OfficeImagePreviewAfterPdfTests（Mockito，不需要 LibreOffice），3 条：

• shouldConvertToImagesWhenOnlyThePdfIsCached：已转换文件缓存里有 cacheName、图片缓存为空时，以图片方式预览应返回等待页，并触发 PDF 转图片；
• shouldRenderCachedImagesWithoutConvertingAgain：图片缓存已存在时直接返回图片预览页，不重新转换；
• shouldRenderEncryptedImageCacheWithoutConvertingAgain：加密文档的图片缓存存在时同样直接渲染，不重新转换。

修改前先跑：第 1 条失败（expected: <waiting> but was: <fileNotSupported>，msg 为「Office转换缓存异常，请联系管理员」），另外 2 条通过；修改后 3 条全部通过。把新增的条件去掉，第 1 条重新失败；只去掉加密缓存那一半，第 3 条失败。

mvn -B -pl server test -Dtest='!ServerMainTests'（Windows，JDK 25）：Tests run: 90, Failures: 0, Errors: 1。唯一的 1 条是 ArchiveDirectorySecurityTests.cachedArchivePreviewRendersItsTreeWithoutAnEnumerationRequest，它要创建文件名带双引号的文件，Windows 不允许，在未修改的 master 上同样失败（master 为 87 条、同样 1 条 Error），与本次修改无关。

Fixes #754