在 RESTful API 中，处理空值（null/undefined）时是一个常见的问题。许多开发人员在开发过程中会遇到这个问题，如何正确处理空值并保持 API 的一致性和正确性将会影响客户端的使用体验和数据的完整性。
空值的意义和影响
在 RESTful API 中，空值可以有不同的含义和影响。通常情况下，它可以表示以下内容：
- 数据尚未就绪或未被创建
- 数据已被删除或不再可用
- 数据已存在但某些字段为 null 或 undefined
对于前两种情况，API 的通常做法是返回 404 状态码。对于第三种情况，最好的做法是返回 200 并包含一个明确表达该属性为空值的字段。
在任何情况下，我们应该避免直接返回 200 状态码并忽略空值。这可能导致客户端无法区分数据是否真的不存在或只是某些属性的值为空。这种情况下，开发人员可能会误解数据，从而导致错误和混乱。
处理空值的方法
关于如何正确处理空值，下面给出了一些可能的方法和建议。
1. 返回空对象或空数组
一种处理空值的方法是返回空对象或空数组。例如，在获取某个订单的信息时，如果订单不存在返回一个空对象或空数组：
{}或者
[]
这种方法的优点是可以避免客户端的错误。如果客户端尝试处理空对象或者空数组，对应的数据会被忽略，而不会引起程序错误。
2. 返回指定的空值
在处理空值的时候，也可以返回指定的空值。例如，在获取某个用户信息时，如果用户的地址信息为空，我们可以返回一个指定的空值，来表示该字段为空。
-- -------------------- ---- -------
-
------- -------
------ ---
---------- -
--------- ---
------- ---
-------- --
-
-这种方法的缺点是在客户端处理时可能会引起错误。如果我们简单地使用了 JavaScript 的 truthy 值（即空字符串和空对象并非 falsy）来判断是否存在地址信息，那么客户端可能会误解数据。
3. 返回 null
返回 null 可能是最常见的空值处理方法。但是，它也存在一些问题。我们需要考虑到空值的含义和应用场景。例如，在用户登录时，返回 null 不是最好的方法，因为这可能使客户端认为出现了错误或者登录失败。因此，通常我们需要根据具体的场景来决定是否返回 null。
{
"error": "Invalid credentials",
"data": null
}注意事项
在处理空值的时候，需要注意以下问题：
1. 保持一致性
在处理 RESTful API 的空值的时候，我们需要保持前后端 API 的一致性。如果前端期望获取的是空对象，但后端返回了 null，这可能会导致客户端无法正确渲染数据，出现错误。因此，我们需要确保 API 的一致性，从而保证客户端和服务端之间的数据处理和沟通更加流畅。
2. 优雅地处理空值
开发人员应该尽可能优雅地处理 RESTful API 中空值的情况。我们需要避免繁琐复杂的代码来处理空值，并找到一个高效、简洁的方法来解决问题。 在代码编写的过程中，我们应该减少硬编码，而是采用数据驱动（data-driven）的方式来处理特定情况的空值。
3. 文档化空值处理
开发人员还应该文档化 RESTful API 中的空值处理方法，并提供示例代码。这有助于其他开发人员更好地理解处理空值的方法和原则，并能快速集成和调用 API。
结论
在 RESTful API 中，我们需要正确处理空值并保持一致性和正确性。我们可以使用空对象或空数组、指定空值或返回 null 等方法来解决问题。对于前两种情况，我们可以返回 404 状态码，对于第三种情况，则应该返回 200 并包含一个明确表达该属性为 null 或 undefined 的字段。最后，我们应该文档化空值处理方法，并提供示例代码，以方便其他开发人员使用和调用 API。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/66ee6f366fbf96019721d10f