知识卡片
策略错误消息要给出具体的修复路径
部署拒绝消息应指出违反哪条策略、期望值及可行修复路径。例如来源 URI 不符时,说明应从正确 URI 重建,或经批准更新允许列表。错误可解释性还会影响策略语言选择:表达力再强,若无法给出可操作反馈,也可能增加排障成本。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- · 查看原书依据
当部署被拒绝时,错误消息必须清楚地说明出了什么问题及其修复方案。例如,如果一个工件因为从不正确的源 URI 构建而被拒绝,那么修复方案可以是更新策略以允许该 URI,或从正确的 URI 重新构建
参考来源
- 位置:《Google系统架构解密:构建安全可靠的系统》第14章《部署代码》14.6.2节提供可操作的错误消息(源文件:`../OREILY动物书合辑 图灵新版/_epub-src/text/part0014_split_117.html`)
- 结论依据:原文明确要求"当部署被拒绝时,错误消息必须清楚地说明出了什么问题及其修复方案",并以Google早期策略语言原型因表达力过强而阻碍可操作错误消息、最终改用更有限语言为具体案例。
- 原始内容:当部署被拒绝时,错误消息必须清楚地说明出了什么问题及其修复方案。例如,如果一个工件因为从不正确的源URI构建而被拒绝,那么修复方案可以是更新策略以允许该URI,或从正确的URI重新构建……Google早期的一个策略语言原型在表达策略时提供了很大的灵活性,但阻碍了提供可操作的错误消息……我们最终放弃了这种方法,转而使用一种策略非常有限的语言。