引言
在构建后端服务时，接口响应不仅仅是数据的传递，更是系统状态的反馈。一个规范统一的 message 字段设计，能显著提升系统的可维护性，减少前后端沟通成本。
设计原则
简洁明了 提示语不宜过长，控制在 3~12 个汉字为宜。避免使用'完成了'、'OK'这类含糊词汇。
统一风格 同一项目内的接口建议遵循统一的动词 + 状态组合，例如：'获取数据成功'、'数据加载完成'。
上下文清晰 提示信息应体现操作对象，如'用户列表获取成功'，而非笼统的'获取成功'。
NestJS 实现方案
在实际开发中，我们通常通过全局异常过滤器和统一的响应 DTO 来落地这些规范。
// 统一响应结构
export class ApiResponse<T> {
success: boolean;
message: string;
data?: T;
}
// 全局异常过滤器示例
@Injectable()
export class AllExceptionsFilter implements ExceptionFilter {
catch(exception: HttpException, host: ArgumentsHost) {
const ctx = host.switchToHttp();
const response = ctx.getResponse();
const status = exception.getStatus();
// 这里可以统一处理错误 message
response.json({
success: false,
message: exception.message || '服务器内部错误',
data: null,
});
}
}
注意，实际运行时建议将具体业务错误码映射到友好的中文提示，日志层保留详细堆栈以便排查。
消息分类与模板
为了兼顾前端展示与后台日志，我们可以对 message 进行分层设计。
前端提示（简洁直观） 获取数据成功、数据加载完成、操作成功、保存成功、更新成功、删除成功。
后端日志（完整清晰） 数据已成功获取、数据获取操作完成、列表数据已返回、数据更新操作已完成、记录已成功删除、请求已成功处理。
列表类提示（带上下文） 用户列表获取成功、设备列表获取成功、订单列表获取成功、日志记录获取成功、配置数据获取成功。
分页 / 带数量提示 列表数据获取成功，共${list.length}条、用户列表加载完成，共${list.length}条、数据获取成功，当前页${page}/共${totalPages}页、数据加载成功，本页${list.length}条，总数${total}条、查询成功，符合条件的数据共${total}条。
操作提示 / 引导型 数据加载成功，可进行下一步操作、操作成功，数据已更新、删除成功，记录已移除、保存成功，请刷新查看、数据获取成功，请查看列表。
国际化支持
在国际化项目中，message 建议使用翻译 Key 而非硬编码字符串。这样既能适配不同语言，又方便后端日志追踪统一标识。
规范化的接口提示是提升用户体验的关键细节，花点时间打磨这部分逻辑，后续维护会轻松很多。