Spring Boot中Gson序列化ThreadLocal字段访问失败问题求助

问题核心 #

你在构建基于JSON文件存储的Watchlist CRUD API时，使用Gson处理序列化/反序列化，POST请求触发无法访问java.lang.ThreadLocal#threadLocalHashCode错误，返回500内部服务器错误，核心需求是将新数据追加到JSON文件的现有列表末尾。

错误原因 #

这个问题90%是Gson版本与JDK版本不兼容导致：

• 高版本JDK（16+）强化了反射访问权限，threadLocalHashCode是ThreadLocal的私有字段，旧版本Gson会尝试通过反射访问该字段，触发IllegalAccessException，进而引发500错误。
• 其次可能是JSON文件读写逻辑错误（比如直接追加文本而非先读取全量数据再修改写入）。

解决方案 #

1. 升级Gson到兼容高JDK的版本 #

确保使用Gson 2.10+版本，该版本已修复JDK16+的反射兼容问题，不再尝试访问ThreadLocal的私有字段。

Maven依赖示例：

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.10.1</version>
</dependency>

Gradle依赖示例：

implementation 'com.google.code.gson:gson:2.10.1'

2. 修正JSON文件读写逻辑 #

JSON数组无法直接追加内容，必须先读取现有全量数据，添加新项后再整体写入文件，以下是修正后的核心代码：

Watchlist实体类（确保是标准POJO）

public class Watchlist {
    private Long id;
    private String title;
    private String genre;
    private Integer rating;

    // Gson序列化必须的无参构造器
    public Watchlist() {}

    // 全参构造器、getter、setter方法
    // ...
}

JSON读写工具类（WriteToJson）

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.reflect.TypeToken;
import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
import java.lang.reflect.Type;
import java.util.ArrayList;
import java.util.List;

public class WriteToJson {
    private static final String FILE_PATH = "watchlist.json";
    private static final Gson GSON = new GsonBuilder().setPrettyPrinting().create();

    // 读取现有Watchlist列表，文件不存在则返回空列表
    public static List<Watchlist> readWatchlist() {
        try (FileReader reader = new FileReader(FILE_PATH)) {
            Type listType = new TypeToken<ArrayList<Watchlist>>(){}.getType();
            return GSON.fromJson(reader, listType);
        } catch (IOException e) {
            return new ArrayList<>();
        }
    }

    // 写入新数据（实现追加逻辑：先读→添加→再写）
    public static void writeWatchlist(Watchlist newItem) {
        List<Watchlist> watchlist = readWatchlist();
        
        // 生成自增ID（作业场景简易实现）
        long newId = watchlist.stream()
                .mapToLong(Watchlist::getId)
                .max()
                .orElse(0) + 1;
        newItem.setId(newId);
        
        watchlist.add(newItem);

        try (FileWriter writer = new FileWriter(FILE_PATH)) {
            GSON.toJson(watchlist, writer);
        } catch (IOException e) {
            throw new RuntimeException("写入JSON文件失败", e);
        }
    }
}

控制器类（CreateWatchlist）

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.ExceptionHandler;

@RestController
public class CreateWatchlist {

    @PostMapping("/watchlist")
    public ResponseEntity<String> createWatchlist(@RequestBody Watchlist newItem) {
        WriteToJson.writeWatchlist(newItem);
        return new ResponseEntity<>("Watchlist项已成功添加", HttpStatus.CREATED);
    }

    // 统一捕获异常，返回具体错误信息便于调试
    @ExceptionHandler(RuntimeException.class)
    public ResponseEntity<String> handleRuntimeException(RuntimeException e) {
        return new ResponseEntity<>("操作失败：" + e.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

3. 额外注意事项 #

• 确保JSON文件路径正确，作业场景可使用绝对路径，或在application.properties中配置路径：watchlist.file.path=/your/absolute/path/watchlist.json
• 并发场景下需添加文件读写锁（作业场景可忽略，生产环境建议补充）

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