yuhaibo c4e1929ecf fix: 水印配置缺失时 xlsx 预览白页 —— officeweb.ftl 补上缺省值 ...

未提供外部 config/application.properties 的部署上，预览任何 xlsx 都失败：
FreeMarker 在 officeweb.ftl 第 25 行抛 InvalidReferenceException，点名
watermarkTxt。DEBUG 模式把错误内联进 HTML，页面断在半截 JavaScript 里、
永远没有 </html>，浏览器上是白页或一直转圈，而 HTTP 状态码是 200 ——
看起来像转换超时，不像模板错。

两处叠在一起：

1. 十个 watermark* 请求属性可能整族不存在。WatermarkConfigConstants 没有
   类级注解（对比 ConfigConstants 上的 @Component），不是 Spring bean，
   那十个 @Value 的 setter 从来不会被调用；唯一填充它们的
   ConfigRefreshComponent#loadConfig() 在配置文件不存在时直接 return。
   于是十个 getter 全返回 null，AttributeSetFilter 的
   setAttribute(name, null) 按 Servlet 规范等同于删除属性。

2. officeweb.ftl 是唯一没有 classic_compatible 兜底的预览模板。
   commonHeader.ftl 第 1 行是 <#setting classic_compatible=true>，
   所有 include 它的模板在属性缺失时把变量渲染成空串、照常出页面；
   officeweb.ftl 既不 include 它、自己也没有这个设置。

缺省值取 WatermarkConfigConstants.DEFAULT_*，watermarkTxt 取空串——
空串会让下一行的 if (watermarkTxt !== '') 跳过 watermark.init()，不会给
所有预览凭空加上水印。其余九个只在水印开着时才用到，但那个 if 是
JavaScript 的、不是模板的，FreeMarker 两条分支都渲染，所以十个都要给。

新增的测试直接用 FreeMarker 渲染这个模板，不需要把服务跑起来：
数据模型里一个 watermark* 都不给（那正是缺陷发生时的情形），断言渲染得出
</html>；另一条把十个值全给上，断言逐个原样渲染，保证缺省值不会盖掉真实配置。
改模板之前先跑过一遍，第一条报 InvalidReferenceException、第二条通过。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-08 00:54:15 -07:00

..

lib

删除文件 server/lib/aspose-cad-23.1.jar

2023-04-25 03:57:33 +00:00

LibreOfficePortable

新增 页码定位 美化前端 其他功能调整等

2026-01-19 17:46:32 +08:00

src

fix: 水印配置缺失时 xlsx 预览白页 —— officeweb.ftl 补上缺省值

2026-09-08 00:54:15 -07:00

pom.xml

chore(release): prepare v5.0.2

2026-08-14 14:28:41 +08:00