Spring MVC JSON 交互實戰：環境搭建、雙向轉換與兩種請求模式對比

依賴準備：Jackson 全家桶

Spring MVC 默認使用 Jackson 進行 JSON 序列化/反序列化。需引入核心三模塊（jackson-databind 會傳遞依賴 core 和 annotations）：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.7.2</version>
</dependency>
<!-- 兼容舊版代碼可選：org.codehaus.jackson:jackson-mapper-asl:1.9.13 -->

配置 HttpMessageConverter

在 RequestMappingHandlerAdapter 中注入 MappingJacksonHttpMessageConverter（或 MappingJackson2HttpMessageConverter 對應 Jackson 2.x）：

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
    <property name="messageConverters">
        <list>
            <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter" />
        </list>
    </property>
</bean>
<!-- 簡化配置：<mvc:annotation-driven /> 自動註冊 -->

兩種交互模式深度對比

模式一：請求 JSON，響應 JSON（@RequestBody + @ResponseBody）

適用場景：前後端分離、WebService 接口、複雜巢狀對象傳輸。

// Controller
@RequestMapping("/requestJson")
public @ResponseBody ItemsCustom requestJson(@RequestBody ItemsCustom itemsCustom) {
    return itemsCustom; // 直接回傳，驗證雙向轉換
}

// 前端 jQuery AJAX
$.ajax({
    type: 'POST',
    url: '/requestJson',
    contentType: 'application/json;charset=utf-8', // 必須聲明
    data: JSON.stringify({name: "手機", price: 999}), // JS對象序列化為JSON字符串
    success: function(data) { console.log(data); }
});

網絡特徵：Request/Response Header 均為 Content-Type: application/json;charset=utf-8。

模式二：請求 Key/Value（表單），響應 JSON

適用場景：傳統表單提交、簡單參數、兼容非 JSON 客戶端。

// Controller：無 @RequestBody，Spring 自動綁定請求參數到對象屬性
@RequestMapping("/responseJson")
public @ResponseBody ItemsCustom responseJson(ItemsCustom itemsCustom) {
    return itemsCustom;
}

// 前端 jQuery AJAX：默認 contentType = application/x-www-form-urlencoded
$.ajax({
    type: 'POST',
    url: '/responseJson',
    data: 'name=手機&price=999', // 字符串或對象 {name:"手機", price:999}
    success: function(data) { alert(data.name); }
});

網絡特徵：Request Header Content-Type: application/x-www-form-urlencoded，Response Header application/json。

核心區別總結表

常見坑與最佳實踐

• 日期格式化：配置 ObjectMapper 統一 yyyy-MM-dd HH:mm:ss，避免時間戳/ISO8601 不一致。
• 忽略空值：@JsonInclude(Include.NON_NULL) 減少傳輸體積。
• 防止循環引用：雙向關聯實體加 @JsonIgnore 或 @JsonBackReference。
• 全局異常處理：@ControllerAdvice 捕獲 HttpMessageNotReadableException 返回友好錯誤碼。