FastJSON 默认行为：JSON.toJSONString 忽略 null 字段

完整的 FakeRegistrationController 代码，这让我可以全面分析后端逻辑，特别是为什么空的字段（如 compareDate）不返回给前端。我将详细分析代码的每个接口，尤其是与 list 请求和字段返回相关的部分，并解释原因。

代码结构总览

FakeRegistrationController 是一个 RESTful 控制器，提供了三个接口：

POST /fakeRegistration/registration/save：保存或修改假货登记信息。
POST /fakeRegistration/compare/save：保存或修改比对结果。
GET /fakeRegistration/list：获取假货登记列表（对应前端的 qlist 请求）。

我们关心的是 list 接口，因为它直接决定了前端表格接收到的数据内容，特别是为何空的 compareDate 不返回。

详细分析 `list` 接口

接口定义

@GetMapping("list")
@ApiOperation("假货登记列表")
public BaseResult list(@ApiIgnore @SessionAttribute(Constants.ADMIN_ID) Integer adminId,BasePage page) {Integer vipAdminId = copywritingApiService.getVipAdminId(adminId, 11);Page<FakeRegistration> fakeRegistrationPage = fakeRegistrationService.findByAdminId(vipAdminId, page);List<FakeRegistration> fakeRegistrations = fakeRegistrationPage.getContent();List<FakeRegistrationListDTO> fakeRegistrationListDTOS = new ArrayList<>();for (FakeRegistration fakeRegistration: fakeRegistrations) {FakeRegistrationListDTO fakeRegistrationListDTO = JSON.parseObject(JSON.toJSONString(fakeRegistration), FakeRegistrationListDTO.class);if (null != fakeRegistration.getProductId()) {Product product = productService.findById(fakeRegistration.getProductId()).orElseThrow(() -> new RuntimeException("未找到商品信息"));fakeRegistrationListDTO.setProductName(product.getName());}Admin creator = adminService.findById(fakeRegistration.getCreatorId()).orElseThrow(() -> new RuntimeException("未找到创建人信息"));fakeRegistrationListDTO.setCreatorName(StringUtils.isEmpty(creator.getNickname()) ? creator.getUsername() : creator.getNickname());fakeRegistrationListDTO.setGenuineIdentificationPoints(fakeRegistrationApiService.findIdentification(fakeRegistration.getId(), 1));fakeRegistrationListDTO.setFakeIdentificationPoints(fakeRegistrationApiService.findIdentification(fakeRegistration.getId(), 0));fakeRegistrationListDTOS.add(fakeRegistrationListDTO);}return BaseResult.success(new PageImpl<>(fakeRegistrationListDTOS, PageRequest.of(fakeRegistrationPage.getNumber(), fakeRegistrationPage.getSize()), fakeRegistrationPage.getTotalElements()));
}

数据流分析

数据查询：
- fakeRegistrationService.findByAdminId(vipAdminId, page) 返回一个 Page<FakeRegistration>，其中 FakeRegistration 是数据库实体类，包含所有字段（如 id, createdDate, compareDate, comparisonStatus 等）。
- fakeRegistrations 是分页内容的 List<FakeRegistration>。
数据转换：
- 每个 FakeRegistration 被转换为 FakeRegistrationListDTO：
```
FakeRegistrationListDTO fakeRegistrationListDTO = JSON.parseObject(JSON.toJSONString(fakeRegistration), FakeRegistrationListDTO.class);
```
- 这里使用了 FastJSON（com.alibaba.fastjson.JSON）进行序列化和反序列化：
  - JSON.toJSONString(fakeRegistration) 将 FakeRegistration 转为 JSON 字符串。
  - JSON.parseObject(..., FakeRegistrationListDTO.class) 将 JSON 字符串转为 FakeRegistrationListDTO 对象。
- 然后手动补充了：
  - productName：从 ProductService 获取。
  - creatorName：从 AdminService 获取。
  - genuineIdentificationPoints 和 fakeIdentificationPoints：从 FakeRegistrationApiService 获取。
返回结果：
- 返回一个 PageImpl<FakeRegistrationListDTO>，最终被序列化为 JSON 响应。

为什么空的字段（如 `compareDate`）不返回？

FastJSON 的默认行为：
- FastJSON 在序列化时，默认忽略 null 值字段，除非显式配置 SerializerFeature.WriteMapNullValue。
- 如果 FakeRegistration 的 compareDate 是 null，JSON.toJSONString(fakeRegistration) 生成的 JSON 字符串不会包含 "compareDate"。
- 示例：
```
FakeRegistration fr = new FakeRegistration();
fr.setId(34);
fr.setComparisonStatus(1);
fr.setCompareDate(null); // 为空
String json = JSON.toJSONString(fr);
// 输出: {"id":34,"comparisonStatus":1}
```
- 反序列化到 FakeRegistrationListDTO 时，由于 JSON 中没有 compareDate，fakeRegistrationListDTO 的 compareDate 字段不会被赋值，最终返回的 JSON 也不会包含它。
业务逻辑：
- 从其他接口看，compareDate 只有在 compare/save 接口保存比对结果时才会设置：
```
fakeRegistrationOrigin.setCompareDate(new Date());
```
- 在 registration/save 接口中，新建记录时没有设置 compareDate，它保持为 null。
- 因此，未完成比对的记录（comparisonStatus = 0 或 1）在数据库中 compareDate 就是 NULL，序列化后被忽略。
DTO 定义的影响：
- 如果 FakeRegistrationListDTO 中定义了 compareDate：
```
public class FakeRegistrationListDTO {private Integer id;private Date compareDate; // 假设是这样// 其他字段
}
```
- 当 JSON.parseObject 处理没有 compareDate 的 JSON 时，fakeRegistrationListDTO.compareDate 会是 null，但后续的序列化（返回给前端时）仍由 FastJSON 处理，又会被忽略。

其他接口的补充分析

1. `registration/save`

@PostMapping("registration/save")
public BaseResult save(@RequestBody FakeRegistration fakeRegistration, ...) {if(null != fakeRegistration.getId()) {FakeRegistration fakeRegistrationOrigin = fakeRegistrationService.findById(fakeRegistration.getId()).orElseThrow(...);fakeRegistration = SqlUtil.mergeObject(fakeRegistration, fakeRegistrationOrigin);if(null != fakeRegistration.getCompareResult() && fakeRegistration.getCompareResult() == 1) {fakeRegistrationOrigin.setComparisonStatus(3);} else if(null != fakeRegistration.getCompareResult() && fakeRegistration.getCompareResult() == 0) {fakeRegistrationOrigin.setComparisonStatus(2);}} else {fakeRegistration.setAdminId(vipAdminId);fakeRegistration.setCreatorId(adminId);}fakeRegistration = fakeRegistrationService.save(fakeRegistration);...
}

关键点：
- 新建记录时（fakeRegistration.getId() == null），只设置了 adminId 和 creatorId，没有初始化 compareDate，它默认为 null。
- 修改记录时，如果提供了 compareResult，会更新 comparisonStatus，但不会设置 compareDate。
- 因此，compareDate 在这个接口中始终不会被赋值。

2. `compare/save`

@PostMapping("compare/save")
public BaseResult compareSave(@RequestBody FakeRegistrationSaveDTO fakeRegistration, ...) {FakeRegistration fakeRegistrationOrigin = fakeRegistrationService.findById(fakeRegistration.getId()).orElseThrow(...);fakeRegistrationOrigin.setCompareResult(fakeRegistration.getCompareResult());fakeRegistrationOrigin.setCompareDate(new Date());fakeRegistrationService.save(fakeRegistrationOrigin);...
}

关键点：
- 这里显式设置了 compareDate = new Date()，表示比对完成的时间。
- 只有通过这个接口保存比对结果时，compareDate 才会被赋值。
- 这解释了前端数据中，只有 comparisonStatus = 2 或更高状态的记录有 compareDate。

综合结论：为什么空的字段不返回？

数据来源：
- compareDate 在数据库中默认为 NULL，除非通过 compare/save 接口保存比对结果时才会被赋值。
- 未完成比对的记录（comparisonStatus = 0 或 1）没有 compareDate 值。
FastJSON 序列化：
- list 接口中，JSON.toJSONString(fakeRegistration) 将 FakeRegistration 转为 JSON 时，默认忽略 null 字段。
- 如果 compareDate 是 null，它不会出现在 JSON 字符串中。
- 反序列化到 FakeRegistrationListDTO 后，compareDate 仍未被赋值，最终返回的 JSON 也不包含这个字段。
业务逻辑：
- 设计上，compareDate 只有在比对完成时才有意义，未完成时保持 null 并被忽略是合理的。
最终返回：
- Spring Boot 的 @RestController 使用 Jackson（或其他配置）将 PageImpl<FakeRegistrationListDTO> 序列化为 JSON，同样忽略 null 字段，进一步确保空的 compareDate 不出现在响应中。

前端数据的验证

你的前端数据：

id: 34, 33, 32（comparisonStatus = 0 或 1）：没有 compareDate，因为未调用 compare/save。
id: 31, 30, 28（comparisonStatus = 2）：有 compareDate，因为通过 compare/save 设置了值。

改进建议

如果希望空的 compareDate 也返回（例如 "compareDate": null）：

修改 FastJSON 配置：

FakeRegistrationListDTO fakeRegistrationListDTO = JSON.parseObject(JSON.toJSONString(fakeRegistration, SerializerFeature.WriteMapNullValue),FakeRegistrationListDTO.class
);

添加 WriteMapNullValue，确保 null 字段被包含。

调整 DTO：

在 FakeRegistrationListDTO 中显式处理：

fakeRegistrationListDTO.setCompareDate(fakeRegistration.getCompareDate() != null ? fakeRegistration.getCompareDate() : null);

全局配置：

在 Spring Boot 中配置 Jackson：

@Bean
public ObjectMapper objectMapper() {ObjectMapper mapper = new ObjectMapper();mapper.setSerializationInclusion(JsonInclude.Include.ALWAYS);return mapper;
}