spring boot 全局异常处理可以通过在 @controlleradvice 中捕获 jsonexception 来拦截 fastjson 解析异常。具体做法是引入 com.alibaba.fastjson.jsonexception,并在 @exceptionhandler 方法参数中声明该类型,这样当 fastjson 抛出格式错误、类型转换失败等异常时,控制器会统一返回自定义的 json 响应。

如何配置全局异常处理器拦截 Fastjson 异常
要拦截 Fastjson 异常,需要创建一个继承自 ResponseEntityExceptionHandler 或仅使用 @RestControllerAdvice 的类。在该类中定义一个方法,使用 @ExceptionHandler(JSONException.class) 注解。Fastjson 在反序列化 JSON 字符串为 Java 对象时,如果字段缺失、类型不匹配或语法错误,都会抛出 JSONException。通过捕获这个异常,可以防止应用崩溃并返回友好的错误信息。

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONException;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(JSONException.class)
public ResponseEntity<string> handleJsonException(JSONException ex) {
// 记录日志
System.err.println("JSON Parse Error: " + ex.getMessage());
// 返回自定义错误响应
return ResponseEntity.status(HttpStatus.BAD_REQUEST)
.body("{" + "\"error\": \"Invalid JSON format\", " + "\"message\": \"" + ex.getMessage() + "\"}" + ")
}
}</string>
上述代码展示了完整的异常处理器实现。当请求体中的 JSON 无法被 Fastjson 正确解析时,handleJsonException 方法会被触发。它返回 HTTP 400 状态码和一个包含错误详情的 JSON 字符串。开发者可以直接复制这段代码到项目中,确保引入了 Fastjson 依赖。注意,这里返回的是纯文本 JSON 字符串,实际生产中建议封装统一的 Result 对象。
Fastjson 解析异常的具体触发场景有哪些
Fastjson 解析异常主要发生在将 JSON 字符串转换为 Java 对象的过程中。常见的触发场景包括:JSON 字符串格式错误(如缺少引号、逗号)、目标类属性与 JSON 键名不匹配且未配置忽略策略、以及类型转换失败(如将字符串赋值给 int 类型)。这些情况都会导致 JSONException 被抛出,从而被全局异常处理器捕获。
将包含oralBroadcastingList、materialList、bgmInfo等字段的JSON视频素材转换为剪映API可用的自然语言描述,用于生成视频制作指令,包括素材匹配、时间轴计算、字幕同步、特殊效果处理等。

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONException;
public class JsonTest {
public static void main(String[] args) {
String validJson = "{\"name\":\"Alice\",\"age\":25}";
String invalidJson = "{\"name\":\"Bob\", age:30}"; // 键名无引号
try {
User user = JSON.parseObject(invalidJson, User.class);
} catch (JSONException e) {
System.out.println("Caught: " + e.getClass().getSimpleName());
}
}
}
class User {
private String name;
private int age;
// getters and setters
}
以上代码演示了两种 JSON 字符串的处理。第一个是合法的,第二个因为键名 age 没有双引号,Fastjson 会抛出 JSONException。运行这段代码,控制台会输出 “Caught: JSONException”,证明异常已被成功捕获。这验证了全局异常处理器在实际应用中能够有效拦截此类错误。开发者可以根据实际需求调整错误信息的格式和 HTTP 状态码。
当 Fastjson 遇到未知字段时会发生什么
默认情况下,Fastjson 在解析 JSON 时如果遇到 Java 类中不存在的字段,会根据配置决定是否抛出异常。如果开启了 Feature.IgnoreNotParseField,则会忽略未知字段而不报错;否则,可能会抛出 JSONException 或根据版本不同行为有所差异。在全局异常处理中,这种异常也会被 @ExceptionHandler(JSONException.class) 捕获。因此,了解 Fastjson 的配置对正确处理异常至关重要。










