先记住这个答案
type/title/status/detail/instance 字段职责。回答“REST 错误响应体应该包含哪些字段,为什么推荐 RFC 9457 problem+json 格式?”时,先把这句话作为结论。接着指出代码中触发该行为的那一步,并说明先定义资源、输入约束、权限和错误格式,再选择接口表达方式。最后补充客户端能否稳定解析响应、区分错误并安全重试,就形成了完整、可验证的回答。
- type/title/status/detail/instance 字段职责
- 用最小代码对照变化前后的结果
- 先讲正常路径,再补一个容易忽略的边界
先用最小代码看清现象
下面的片段只演示“错误响应格式 problem details RFC 9457”最关键的一步。先顺着正常路径读一遍,再改动一个输入,就能直接看到结论在什么条件下成立。
阅读时重点找出哪一行对应“type/title/status/detail/instance 字段职责”,然后观察客户端能否稳定解析响应、区分错误并安全重试。这样比从定义开始背更容易留下具体印象。
# REST 错误响应体应该包含哪些字段,为什么推荐 RFC 9457 problem+json 格式?
curl --include --request GET \
--header 'Accept: application/json' \
'https://example.test/resource'
# 对照请求头、状态码、响应头与响应体,不只看“请求成功”这段代码针对“错误响应格式 problem details RFC 9457”保留了最关键的操作。先看type/title/status/detail/instance 字段职责如何体现在代码里,再改变一个输入观察结果,能更快理解题目的边界。
代码背后的原因
type/title/status/detail/instance 字段职责。示例把这个机制放进了真实的 API、语法或配置中,因此要关注产生结果的操作,而不是把整段代码当成固定模板照抄。
先定义资源、输入约束、权限和错误格式,再选择接口表达方式。对“type/title/status/detail/instance 字段职责”来说,如果这个条件改变,相同代码可能进入另一条分支、返回不同状态,甚至根本不执行。
放到真实项目里怎么判断
接口一旦被多个客户端依赖就很难随意修改,因此兼容性、幂等性和可观测错误必须提前设计。验证“type/title/status/detail/instance 字段职责”时先保留正常路径,再增加一个直接相关的反例。一次只改一个条件,才能知道差异究竟来自哪里。
验证“错误响应格式 problem details RFC 9457”不能只看有没有报错,还要检查客户端能否稳定解析响应、区分错误并安全重试。涉及资源或异步任务时,也要确认结束后是否正确取消、关闭或释放。
容易答错的地方
- 记住结论,却忘了前提
- 只复述“type/title/status/detail/instance 字段职责”仍可能答错,因为它依赖先定义资源、输入约束、权限和错误格式,再选择接口表达方式。先说适用条件,再说结果。
- 用一次现象证明所有情况
- 单次成功只能说明当前输入可用。至少增加一个反例,并检查客户端能否稳定解析响应、区分错误并安全重试,才能区分偶然现象与稳定机制。
面试官还会怎么问?
面试时怎样在半分钟内回答这道题?
先说结论:type/title/status/detail/instance 字段职责。再补一句前提是先定义资源、输入约束、权限和错误格式,再选择接口表达方式,最后用示例中的结果说明如何验证即可。
怎样证明答案不是只在一个环境里碰巧成立?
保留基线,只改变与“错误响应格式 problem details RFC 9457”直接相关的条件,然后重复检查客户端能否稳定解析响应、区分错误并安全重试。版本敏感时记录运行时和依赖版本。
什么情况下需要重新考虑这个结论?
当“type/title/status/detail/instance 字段职责”所依赖的输入、执行顺序或运行环境不再满足“先定义资源、输入约束、权限和错误格式,再选择接口表达方式”时,就应重新验证,不能直接沿用原判断。
参考资料
示例用于理解所注明的运行环境与边界;延伸学习可结合原文中的更多案例。