只读描述符是运行时拦截写入的硬性防线，它让任何修改尝试在python解释器层面直接失败，而非依赖文档提醒或命名约定；通过readonlydescriptor类的__set__抛出attributeerror，可彻底阻止点号赋值、setattr、__dict__操作等所有写入方式，并需配合类型标注final、审计日志、序列化控制与启动校验实现全链路安全。

只读描述符是运行时拦截写入的硬性防线，它让任何修改尝试在 Python 解释器层面直接失败，而不是靠文档提醒或命名约定来“建议别改”。对流式支付配置这类高敏感对象，这是防止金额、回调地址、密钥等字段被篡改的第一道技术锁。

为什么普通方式拦不住支付配置篡改

普通公有属性可被任意赋值；@property 虽省略 setter，但依然能用 setattr(obj, 'timeout', 999) 或直接操作 obj.__dict__ 绕过。在异步支付场景中，多个协程共享同一配置实例，若缺乏原子性控制，一次误赋值就可能污染全局状态，导致订单金额错配、回调发往恶意地址等严重后果。

用描述符实现真正不可写

定义一个 ReadOnlyDescriptor 类，在其 __set__ 方法中固定抛出 AttributeError：

• 任何写入方式都会中断：点号赋值、反射调用、第三方库内部修改，甚至字节码级操作都无法绕过
• 将密钥、超时阈值、异步重试次数、回调 URL 等字段全部声明为该描述符的类级实例（绑定在类上，而非动态挂到实例）
• 避免描述符本身被替换：不暴露描述符类的引用，不在运行时重新赋值类属性

配合异步与安全链加固

只读描述符管住“能不能写”，但还需应对真实运行环境：

• 协程中禁止缓存配置副本（如 dict/list），始终通过描述符访问原始值，避免副本被意外修改后覆盖逻辑
• 序列化传出时（例如发给风控服务），重写 __getstate__，只导出允许公开的字段，排除临时计算状态
• 启动时校验配置哈希，并与签名证书比对，防磁盘文件被篡改后加载；敏感值初始化即解密，全程以明文驻留于只读描述符中，不暴露密钥
• 每次访问关键字段（如 payment_amount_limit）自动记录调用栈和时间戳到审计日志（非高频字段适用）

静态检查与类型协同

光靠运行时拦截不够，开发阶段就要卡死误操作：

• 字段类型标注使用 typing.Final，配合 mypy 静态检查，在编码期报错 "Cannot assign to final attribute"
• IDE 和 CI 流程中启用类型检查，把 config.amount = 100 这类语句直接挡在提交前
• 不依赖 Object.freeze() 或浅层只读包装——它们对嵌套可变对象完全无效