Thymeleaf自定义方言失效求助：自定义处理器无法解析值

我来帮你分析下这个问题，结合你使用的Spring Boot 1.5.9和Thymeleaf 3.0.9版本，大概率是自定义方言的处理器没有正确暴露变量到Thymeleaf的上下文里，或者处理器的执行时机不对，导致直接用${content}无法解析，而th:text能正常工作。下面是具体的排查和解决步骤：

可能的原因与解决步骤 #

1. 检查变量是否被正确暴露到Thymeleaf上下文 #

直接使用${content}时，Thymeleaf会从EvaluationContext中查找变量；如果你的自定义处理器只在处理th:text属性时才赋值变量，那模板渲染到${content}的位置时，上下文里还没有这个变量，自然显示为空。

解决方法：在自定义处理器的process方法中，提前把变量放入上下文，而不是仅在处理属性时赋值。示例代码：

@Override
public void process(ITemplateContext context, IProcessableElementTag tag, AttributeName attributeName, String attributeValue, IElementTagStructureHandler structureHandler) {
    // 提前将content变量暴露到上下文，让${content}能直接获取
    context.getVariables().put("content", "你的自定义内容");
    
    // 你的th:text属性处理逻辑（如果有的话）
    structureHandler.setAttribute("text", "${content}");
}

2. 确认自定义方言与处理器的注册正确性 #

在Spring Boot 1.5.x中，自定义方言需要通过@Bean正确注册，并且处理器要被添加到方言的处理器列表中：

注册自定义方言

@Configuration
public class ThymeleafConfig {
    @Bean
    public IDialect customDialect() {
        return new YourCustomDialect();
    }
}

在方言中注册处理器

public class YourCustomDialect extends AbstractProcessorDialect {
    public YourCustomDialect() {
        super("Custom Dialect", "custom", StandardDialect.PROCESSOR_PRECEDENCE);
    }

    @Override
    public Set<IProcessor> getProcessors(String dialectPrefix) {
        Set<IProcessor> processors = new HashSet<>();
        // 添加你的自定义处理器
        processors.add(new YourCustomProcessor(dialectPrefix));
        return processors;
    }
}

3. 检查Thymeleaf依赖的版本一致性 #

Spring Boot 1.5.9默认依赖的Thymeleaf版本是3.0.9.RELEASE，但要确保所有Thymeleaf相关依赖（比如thymeleaf-spring4、额外的扩展依赖）都使用同一版本，避免依赖冲突导致的解析异常。在pom.xml中统一版本：

<properties>
    <org.thymeleaf-version>3.0.9.RELEASE</org.thymeleaf-version>
    <java-version>1.8</java-version>
</properties>

<dependencies>
    <dependency>
        <groupId>org.thymeleaf</groupId>
        <artifactId>thymeleaf</artifactId>
        <version>${org.thymeleaf-version}</version>
    </dependency>
    <dependency>
        <groupId>org.thymeleaf</groupId>
        <artifactId>thymeleaf-spring4</artifactId>
        <version>${org.thymeleaf-version}</version>
    </dependency>
    <!-- 其他Thymeleaf扩展依赖也保持版本一致 -->
</dependencies>

4. 验证模板解析配置 #

确保你的Thymeleaf模板配置没有禁用变量表达式解析，在application.properties中检查：

spring.thymeleaf.mode=HTML5
spring.thymeleaf.enabled=true
spring.thymeleaf.cache=false <!-- 开发环境关闭缓存，方便调试 -->

5. 调试处理器的执行时机 #

可以在自定义处理器的关键位置添加日志或断点，查看content变量是在什么时候被放入上下文的。如果变量是在th:text属性处理阶段才赋值，那模板中直接写的${content}会先被解析，此时变量还不存在，就会显示为空。

内容的提问来源于stack exchange，提问作者Michał Bil