工具授权与副作用:超时之后先查状态
工具授权与副作用:超时之后先查状态,从执行机制、错误边界与可运行例子理解工程取舍。
扣款已在服务端成功,网络却在返回前断开。客户端看到超时,如果把它解释为“没有执行”并重新生成请求ID,就可能扣两次。副作用工具必须把身份、操作唯一性、结果持久化与状态查询连接起来。
身份来自执行环境
模型可以建议操作参数,但不能自行声明自己是管理员。服务端从认证上下文取得租户、用户和权限,再检查目标对象属于允许范围。最小权限意味着按工具、资源和动作限定;只允许读订单的身份不能因为模型理由充分而获得退款权限。
授权既要在展示候选工具时筛选,也要在真正执行时重验。发现阶段与执行阶段之间可能撤权、额度变化或资源转移。幂等命中返回旧结果时仍需要检查调用者是否能读取该结果,防止用已知请求ID绕过权限。
幂等记录必须绑定操作内容
幂等键通常在租户或用户作用域内唯一,并绑定规范化参数摘要。相同键相同内容返回原结果;相同键不同金额应拒绝。若每次重试都产生新键,服务端无法识别同一业务操作。键保留多久也要与业务重试窗口一致,过早清理会重新放行重复操作。
生产中请求记录和数据库副作用应原子提交,通常借助唯一约束和事务。先记录成功再实际扣款、或先扣款再写记录,都可能在崩溃窗口产生错误。对外部支付系统,使用对方幂等能力、状态查询、事务发件箱和对账等机制组合;本地事务无法直接回滚已经发生的外部转账。
跟做:丢响应后重试仍只扣一次
保存为authorized_effect.py,运行python -X utf8 authorized_effect.py。这是单进程内存账本,既不持久也不支持并发,不能用作真实支付系统;它用于观察授权和幂等检查顺序。
"""内存执行账本演示授权和幂等;不连接支付系统。"""
class Ledger:
def __init__(self):
self.balance = 100
self.results = {}
def debit(self, principal, request_id, amount):
if principal['tenant'] != 'A' or 'debit' not in principal['scopes']:
raise PermissionError('not_authorized')
if type(amount) is not int or amount <= 0:
raise ValueError('invalid_amount')
key = (principal['tenant'], request_id)
if key in self.results:
if self.results[key] != amount:
raise ValueError('idempotency_conflict')
return 'replayed'
if self.balance < amount:
raise ValueError('insufficient_balance')
self.balance -= amount
self.results[key] = amount
return 'committed'
if __name__ == '__main__':
ledger = Ledger()
user = {'tenant':'A','scopes':{'debit'}}
print(ledger.debit(user,'r1',30))
print('模拟响应丢失后重试',ledger.debit(user,'r1',30))
user['scopes'].clear()
try:ledger.debit(user,'r1',30)
except PermissionError as e:print('撤权后',str(e))
print('余额',ledger.balance)实际运行输出:
committed
模拟响应丢失后重试 replayed
撤权后 not_authorized
余额 70第一次扣30后余额70,响应丢失后的同键重试返回replayed。撤销debit权限后,即使是旧键也拒绝。把第二次amount改为40会触发idempotency_conflict,应向调用者说明冲突,不能覆盖旧记录。
超时、取消和补偿的不同含义
超时表示客户端等待结束,不保证远端停止;取消通常只是请求终止,也可能晚于提交。对状态不确定的操作,先按操作ID查账,再决定安全重试或人工对账。不要为“避免重复”而永久标记成功,状态应能表达pending、committed、failed和unknown等业务阶段。
补偿是新的业务操作,例如退回款项,可能有手续费、汇率差和失败风险。应记录原操作与补偿关系,对补偿本身也做幂等和权限校验。审计日志包含谁、基于什么授权、对什么对象做了什么、何时完成以及证据ID,敏感内容按需要脱敏。
综合追问:同键重试命中旧结果,但用户已撤权,还应该返回吗?
这是给定条件下的机制推演;数值用于解释判断,不是新增线上或模型实测。先独立回答,再核对下面的推理。
展开推理、取舍与排错路径
租户/用户来自执行上下文而非模型参数,最小权限限制动作和对象。候选发现时筛选可减少误调用,执行及读取旧幂等结果时仍按当前身份检查;否则已知操作ID就可能绕过撤权。幂等键绑定作用域和规范化参数,同键改金额应冲突,键保留期太短会在迟到重试时重复执行。
扣30元后响应丢失,先按原操作ID查账或同键恢复,不能换新ID再扣;单进程字典只解释机制,生产需要持久唯一约束与原子提交。外部支付无法由本地事务回滚,补偿是新操作,可能扣手续费、失败或晚于用户可见结果。审计记录身份、授权、参数版本、提交与补偿关系,敏感值脱敏。面试用提交前后故障窗口说明超时、取消、失败和未知的区别。
课后练习展开习题收起习题
先独立作答,再展开参考思路。检查自己的解释是否包含机制、条件和反例。
超时后能否直接换ID重试?
参考思路与常见误区
不能,操作可能已提交,应使用原操作ID查询或按同一幂等键安全重试。
常见误区:超时等于未执行。
幂等键为何绑定参数?
参考思路与常见误区
防止同一键被复用为不同业务操作;内容不一致需拒绝而非返回误导结果。
常见误区:只看键不看内容。
何时检查授权?
参考思路与常见误区
发现阶段可筛选,执行和读取幂等结果时仍要按当前身份范围重验。
常见误区:工具列出过就永久允许。
内存字典可以实现生产幂等吗?
参考思路与常见误区
不能处理进程重启和多实例竞争,需要持久唯一约束、事务与明确过期策略。
常见误区:单次测试成功等同持久可靠。
补偿等于回滚吗?
参考思路与常见误区
补偿是可失败的新业务操作,可能无法恢复时间、费用和外部影响。
常见误区:认为世界能自动恢复原样。
协议与接口细节请对照:官方资料1。