快捷導(dǎo)航

Springboot中Controller和RestController的使用及區(qū)別

更新時(shí)間：2025年11月21日 09:59:15 作者：IT小鳥(niǎo)鳥(niǎo)

文章總結(jié)了Spring框架中@Controller和@RestController的區(qū)別,包括它們的用途、工作機(jī)制、使用場(chǎng)景以及底層原理,文章指出,@Controller用于傳統(tǒng)的SpringMVC應(yīng)用,返回視圖或數(shù)據(jù)（需@ResponseBody）

1. 核心區(qū)別

@Controller

用于傳統(tǒng)的 Spring MVC 應(yīng)用，通常返回視圖（View）（如 JSP、Thymeleaf 等）。
若需要返回?cái)?shù)據(jù)（如 JSON/XML），需額外使用 @ResponseBody 注解。

@RestController

是 Spring 4.0 引入的注解，專門用于構(gòu)建 RESTful Web 服務(wù)，直接返回?cái)?shù)據(jù)（JSON/XML）。
它本質(zhì)上是 @Controller + @ResponseBody 的組合，自動(dòng)將返回值序列化為 HTTP 響應(yīng)體。

2. 工作機(jī)制對(duì)比

@Controller

默認(rèn)假設(shè)方法返回的是視圖名稱（View Name），由 ViewResolver 解析為具體頁(yè)面。
若要返回?cái)?shù)據(jù)，需在方法上添加 @ResponseBody，此時(shí)會(huì)通過(guò) HttpMessageConverter 將返回值轉(zhuǎn)換為指定格式（如 JSON）。

@Controller
public class MyController {
    @GetMapping("/page")
    public String showPage() {
        return "home"; // 返回視圖 home.jsp（或類似）
    }

    @ResponseBody
    @GetMapping("/data")
    public User getUser() {
        return new User("Alice"); // 返回 JSON 數(shù)據(jù)
    }
}

@RestController

所有方法默認(rèn)添加了 @ResponseBody，直接返回?cái)?shù)據(jù)，無(wú)需視圖解析。
適合 API 開(kāi)發(fā)，不涉及頁(yè)面渲染。

@RestController
public class MyRestController {
    @GetMapping("/api/user")
    public User getUser() {
        return new User("Bob"); // 自動(dòng)轉(zhuǎn)換為 JSON
    }
}

3. 使用場(chǎng)景

@Controller

適用于需要混合視圖和少量數(shù)據(jù)返回的傳統(tǒng) Web 應(yīng)用（如前后端未分離的場(chǎng)景）。

@RestController

專為 RESTful API 設(shè)計(jì)，適用于前后端分離架構(gòu)，僅返回?cái)?shù)據(jù)（如 JSON/XML）。

4. 底層原理

@Controller 依賴 ViewResolver 解析視圖，而 @RestController 依賴 HttpMessageConverter 轉(zhuǎn)換數(shù)據(jù)。
@RestController 的源碼定義如下，可以看出它是 @Controller 的增強(qiáng)版：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Controller
@ResponseBody
public @interface RestController {}

總結(jié)

特性	@Controller	@RestController
返回類型	視圖（默認(rèn)）或數(shù)據(jù)（需 @ResponseBody）	直接返回?cái)?shù)據(jù)
適用場(chǎng)景	傳統(tǒng) MVC 頁(yè)面渲染	RESTful API
依賴組件	ViewResolver	HttpMessageConverter
注解組合	無(wú)	@Controller + @ResponseBody