GET请求返回未保存用户配置而非404是否符合REST最佳实践？

无资料时返回默认值是否违反REST规范 #

不违反。REST的核心是资源抽象，你完全可以将GET /user-profile对应的资源定义为「用户个人资料逻辑资源」，而非仅映射数据库中已持久化的记录：

• 已有持久化资料时返回存储的内容，HTTP状态码返回200 OK
• 无持久化资料时返回填充默认值的结构，同样返回200 OK，可以额外新增两个字段明确状态：
  • is_persisted: false 标识当前是未保存的默认值
  • missing_required_fields: ["xxx", "yyy"] 明确列出未填充的必填字段，方便前端做表单校验提示

这种方案的优势是开发成本最低，前端无需处理404跳转逻辑，还能减少一次额外的网络请求。

替代方案（适配严格REST规范要求） #

如果你们团队有严格的规范，要求仅已持久化的资源才能返回200、不存在必须返回404，也不需要新增独立接口，可以用查询参数扩展原接口能力：

GET /user-profile?fill_defaults=true

• 不带fill_defaults参数时，无资料返回404 Not Found
• 带fill_defaults=true参数时，无资料返回带默认值的200响应

如果你提到的默认值逻辑确实有多个独立的复用场景（比如其他页面也需要单独拉取用户资料默认值做参考），确实要新增独立接口的话，更推荐用/user-profile/defaults的路径命名，比/defaults/user-profile更符合REST的层级资源命名规范，语义也更清晰。

方案选择优先级 #

1. 优先选择「逻辑资源+状态标识」方案，开发成本最低，前后端逻辑最顺畅
2. 次选查询参数扩展方案，适配严格规范的同时无需新增接口
3. 仅当默认值有多场景独立复用需求时，再考虑新增独立的默认值接口

内容的提问来源于stack exchange，提问作者LostInComputer