兄弟们，对于前后端联调中，对响应数据结构的定义，有没有最佳实践？

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

这是一个创建于 270 天前的主题，其中的信息可能已经有所发展或是发生改变。

目前根据我的工作经验，只能得到如下的三种情况，是否有改进空间呢？

正常请求响应数据

httpCode = 200
responseData

{
	message: "获取数据成功",
	code: 0,
	data: {}
}

业务错误响应数据

httpCode = 200
responseData
请求-响应链路没有问题，但是业务逻辑出错了

{
	message: "业务错误",
	code: 10000,
	data: null,
}

前后端，提前约定好 code = 10000 的具体业务含义

请求-响应过程错误响应数据
- httpCode ≠ 200
- responseData
- 请求-响应链路有问题，比如接口 4XX ，5XX 了
```
{
	message: "服务错误",
	code: 0,
	data: null,
}
```

11 条回复 • 2024-02-28 22:57:55 +08:00

Zhuzhuchenyan

270 天前

这个应该是没有所谓的“最佳实践的”，光业务错误是否使用 HTTP 状态码就分两种流派，剩下的细分实践可以吵的点就太多了。

个人感觉这套没什么大问题，完全可以作为开始慢慢迭代，我的话会在返回 4xx ，5xx 的时候把 code 变成-1

剩下的话要思考的可能就是怎么更好约束什么是业务错误，什么是服务错误，分页逻辑用的字段定义在哪里。