Spring Boot REST控制器无法返回HTML字符串问题排查

AI 小北

2026-5-15

问题分析与解决方案

嘿，我一眼就发现几个导致你得到空响应的问题，咱们一步步来修正：

1. 方法返回类型错误

你把confirmRegistration的返回类型设成了void，这意味着Spring会默认认为这个接口不需要返回任何内容——哪怕你写了return ResponseEntity.ok(...)也会被直接忽略，这就是日志能打印但返回空的核心原因！

2. 必须显式指定响应的Content-Type

@RestController默认会把返回的字符串按JSON格式处理，就算你返回HTML代码，它也会给你套上引号转成JSON字符串，浏览器拿到后只会显示纯文本而不会渲染成HTML页面。所以必须手动把响应的媒体类型设为text/html。

3. HTML字符串的语法问题

Java里字符串不能用单引号包裹，内部的双引号需要转义；如果你的项目用的是Java 15+，也可以用文本块（"""）来编写HTML，代码会更清爽易读。

修改后的完整代码

@RestController
@RequestMapping("v1/data/accounts")
public class AccountResource {
    // 六个纯数据的RESTful接口
    
    @GetMapping("/confirmRegistration")
    public ResponseEntity<String> confirmRegistration(@RequestParam(value = "vt") String token) {
        // 业务逻辑
        System.out.println("This should work!");
        
        // 方式1：转义双引号的普通字符串写法
        String htmlContent = "<HTML><body>Hey you did a good job!.</body></HTML>";
        
        // 方式2：Java 15+ 文本块写法，更易读
        // String htmlContent = """
        //         <HTML>
        //             <body>Hey you did a good job!.</body>
        //         </HTML>
        //         """;
        
        return ResponseEntity.ok()
                .contentType(MediaType.TEXT_HTML)
                .body(htmlContent);
    }
}