Apache Velocity 2.0迁移后parseTemplate()换行丢失问题求助

算力阿峰

2026-8-20

解决Velocity 2.0迁移后模板输出换行异常问题

检查Velocity 2.0的空白处理配置
Velocity 2.0默认启用了更严格的空白优化策略，trim_blocks和strip_whitespace两个参数会影响模板中换行和空白的保留。这很可能是导致换行被合并的原因，需要调整配置：
- 设置trim_blocks=false：禁止自动修剪模板块末尾的空白字符
- 设置strip_whitespace=false：保留模板中的原始空白与换行格式
  配置代码示例：
```
Properties props = new Properties();
props.setProperty("trim_blocks", "false");
props.setProperty("strip_whitespace", "false");
VelocityEngine engine = new VelocityEngine(props);
engine.init();
```
调整模板中的换行写法
如果模板中存在指令或特殊标记，Velocity 2.0可能会自动合并其后的换行。可以通过两种方式强制保留格式：
- 使用原生文本块#[[...]]#包裹需要严格保留格式的内容，比如：
```
!
#[[sip-ua]]#
```
- 在需要换行的位置手动添加强制换行符\n，比如：
```
!\n
sip-ua
```
排查输出流的额外处理逻辑
确认调用parseTemplate()时，接收输出的流（如StringWriter）没有被手动添加trim、合并换行等处理代码，避免后续操作破坏模板输出的原始格式。
精细调整空白控制参数
如果上述配置仍不满足需求，可以尝试使用Velocity 2.0新增的whitespace_control参数，该参数支持更精细的空白保留规则，可根据模板的具体结构按需设置。