DRF ModelSerializer 返回字典包含 None 值问题排查与解决

本文将围绕 DRF ModelSerializer 序列化时返回包含 None 值的字典的问题展开讨论。正如摘要所述，该问题通常是由于序列化的对象类型与 Serializer 期望的类型不匹配导致的。下面我们将详细分析问题原因，并提供两种有效的解决方案。

问题分析

当使用 DRF 的 ModelSerializer 时，需要确保传递给 Serializer 的数据类型与 Serializer 的预期类型一致。 在提供的代码示例中，以下代码段存在问题：

like = Like.objects.filter(post_liked=post.pk, like_author=user.pk) obj = LikeSerializer(like).data

Like.objects.filter() 返回的是一个 queryset，即使查询结果只包含一个对象，它仍然是一个 queryset 对象。而 LikeSerializer 默认情况下期望接收一个 Like 模型的实例，而不是一个 queryset。 这导致 Serializer 无法正确地从 queryset 中提取数据，从而返回包含 None 值的字典。

解决方案

有两种方法可以解决这个问题：

1. 使用 many=True 参数

如果查询结果可能包含多个对象，应该在实例化 Serializer 时使用 many=True 参数，告诉 Serializer 这是一个 queryset，需要序列化其中的所有对象。

like = Like.objects.filter(post_liked=post.pk, like_author=user.pk) obj = LikeSerializer(like, many=True).data

这样，LikeSerializer 就会正确地序列化 queryset 中的每个 Like 对象，并返回一个包含多个字典的列表。

2. 使用 .first() 方法

如果预期查询结果最多只有一个对象，可以使用 .first() 方法从 queryset 中获取第一个对象（如果存在）。如果查询结果为空，.first() 将返回 None。

like = Like.objects.filter(post_liked=post.pk, like_author=user.pk).first() obj = LikeSerializer(like).data

这样，LikeSerializer 将接收到一个 Like 模型的实例（或者 None），并正确地进行序列化。 注意： 如果 like 为 None， LikeSerializer(like).data 将返回 None。 你需要根据业务逻辑处理 None 的情况，避免程序出错。 例如，可以在视图中添加一个判断：

like = Like.objects.filter(post_liked=post.pk, like_author=user.pk).first() if like:     obj = LikeSerializer(like).data else:     obj = {}  # 或者其他默认值

总结

在使用 DRF 的 ModelSerializer 时，务必确保传递给 Serializer 的数据类型与 Serializer 的预期类型一致。如果需要序列化 queryset，请使用 many=True 参数。如果预期查询结果最多只有一个对象，可以使用 .first() 方法获取单个实例。同时，也要注意处理可能出现的 None 值，确保程序的健壮性。 通过理解和应用这些技巧，可以避免 ModelSerializer 返回包含 None 值的字典的问题，并编写出更健壮、更可靠的 DRF 应用程序。