Spring MVC如何根据支付结果条件返回HTML内容或Thymeleaf模板？

嘿，你的思路其实已经找对方向了，但有个关键细节容易踩坑——直接返回HTML字符串的话，Spring MVC默认会把它当成视图名称去查找模板，这肯定会报错。咱们来调整一下，让这个条件返回逻辑正常工作：

Spring MVC中控制器方法的返回值有两种核心行为：

• 返回字符串模板名时，会交给Thymeleaf等视图解析器渲染成HTML响应
• 返回原始HTML内容时，需要明确告诉Spring直接输出该内容，而非解析视图

下面给你两种最实用的实现方式：

方式1：用ResponseEntity区分成功/失败场景 #

这种方式最直观，成功时直接返回外部HTML内容，失败时返回Thymeleaf模板名：

@PostMapping(value = "/payment3ds/{offerId}/{company}")
public Object payment3dsPost(
        @PathVariable(value = "offerId") String offerId,
        @PathVariable(value="company") String companyName,
        @ModelAttribute("startSubscriptionRequest") StartSubscriptionRequest formInput,
        Model model) {
    try {
        String htmlContent = endpointsNoAuth.startSubscription3ds(formInput);
        // 成功时：直接返回外部HTML，指定正确的Content-Type
        return ResponseEntity.ok()
                .contentType(MediaType.TEXT_HTML)
                .body(htmlContent);
    } catch (IllegalArgumentException e) {
        Offer plan = subscriptionPlanRepo.findOneByIdAndCompanyName(Long.valueOf(offerId), companyName);
        model.addAttribute("subscriptionPlan", plan);
        model.addAttribute("errorText", e.getMessage());
        // 失败时：返回Thymeleaf模板名，交给视图解析器渲染
        return "payment3ds";
    }
}

方式2：手动渲染Thymeleaf模板（更精细控制） #

如果需要对失败场景的模板渲染做更自定义的控制，可以注入TemplateEngine手动渲染模板为字符串，统一返回HTML内容：

@Autowired
private TemplateEngine templateEngine;

@PostMapping(value = "/payment3ds/{offerId}/{company}")
@ResponseBody // 告诉Spring直接返回字符串内容
public String payment3dsPost(
        @PathVariable(value = "offerId") String offerId,
        @PathVariable(value="company") String companyName,
        @ModelAttribute("startSubscriptionRequest") StartSubscriptionRequest formInput,
        HttpServletRequest request,
        HttpServletResponse response) {
    try {
        String htmlContent = endpointsNoAuth.startSubscription3ds(formInput);
        return htmlContent;
    } catch (IllegalArgumentException e) {
        Offer plan = subscriptionPlanRepo.findOneByIdAndCompanyName(Long.valueOf(offerId), companyName);
        // 创建Thymeleaf上下文，添加模板所需属性
        WebContext context = new WebContext(request, response, request.getServletContext());
        context.setVariable("subscriptionPlan", plan);
        context.setVariable("errorText", e.getMessage());
        // 手动渲染模板为HTML字符串
        return templateEngine.process("payment3ds", context);
    }
}

• Content-Type必须正确：返回外部HTML时，一定要确保响应的Content-Type是text/html，避免浏览器把HTML当成纯文本显示
• 异常范围覆盖：当前只捕获了IllegalArgumentException，建议根据实际业务补充其他可能的异常（比如服务调用超时、网络异常等），避免未捕获异常导致500错误
• XSS风险防范：如果外部服务返回的HTML不可信，要警惕XSS攻击，必要时对内容进行过滤或转义（业务允许的前提下）

内容的提问来源于stack exchange，提问作者Halil