IDPS Rust 全量评审合并规则
来源:Trail of Bits、awesome-skills、BeautifulRust 的去重、中文改写与语义校正;另加明确标注的 IDPS 项目约束。来源编号分别见 Trail of Bits、awesome-skills、BeautifulRust。版本、校正和许可见 README;本文件按 CC BY-SA 4.0 提供。
使用和判定方法
本次检查完整范围内的已有缺陷,不只检查最近 diff。优先级为:逻辑和数据正确性、资源和并发正确性、安全边界、错误处理与可维护性。先读取适用的 AGENTS.md、CLAUDE.md、Cargo.toml、工具链和模块协议。评审不授权自动修改代码。
每条发现必须给出:规则 ID、文件与行号、触发输入/执行顺序、实际影响、代码证据、最小修复建议和建议的回归场景。跨文件结论需列出关键调用者/被调用者;看不到所需上下文时标为“待验证”,不得补造代码或运行结果。只声称实际执行过的编译、测试、Miri 或 fuzz 结果。
按“已证实缺陷 / 项目规范违规 / 待验证疑点 / 改进建议”说明结论性质,并另行说明严重度。内存不安全、数据损坏、认证绕过、不可恢复的服务中断优先;缺注释、命名或没有启用某个 lint 本身不证明高危漏洞。无需为每个检查项制造发现;同一根因和修复点合并,保留不同触发路径。
以下 R01–R38 是通用规则;I01–I07 是 IDPS 约束。风格项仅在有明确维护成本或项目要求时提出建议;既有架构、协议和兼容约定优先。机器可验证的格式/lint 交给现有检查;对工具输出仍需核对适用条件。
一、逻辑、错误和数据正确性
- R01 外部输入与状态机:检查长度、范围、状态迁移、重复事件、乱序及失败后重试的业务语义。校验在分配或副作用前完成,非法/缺失状态不被默认值伪装成成功。来源:A-19、B-07、B-14。
- R02 panic 可达性:追踪外部输入和实际业务路径到 unwrap/expect、assert、unreachable、下标与 RefCell 借用冲突;区分线程/任务终止和 panic=abort 的进程影响。证明已有边界约束后不误报安全下标。来源:UNWRAP、ASSERTREACH、OOBIDX、REFCELLPANIC、A-15。
- R03 数值和字符串边界:核对溢出、截断、符号转换、除零、MIN/-1、NaN/Inf 和 UTF-8 字符边界。按业务选择 checked、饱和或回绕语义,不自动将所有 as 判错。来源:ARITHOFL、LOSSYFROM、FLOATEDGE、STRSLICE。
- R04 错误传播和上下文:关键 Result 不静默丢弃;错误保留原因、操作与脱敏参数,在负责层处理/记录;避免 .ok()、默认回退或 map_err 丢掉需要诊断的原因。来源:RESDISC、A-14、A-15、A-22、B-16。
- R05 错误类型与清理:库的可处理错误类型供调用者匹配;应用层使用项目约定的上下文错误。Drop 不依赖可失败的关键提交或 panic;需要确认成功的关闭/刷新使用显式接口并处理错误。来源:DROPPANIC、BUFFLUSH、B-15、B-16、B-17。
- R06 类型与集合契约:Eq/Ord/PartialOrd/Hash 语义一致;进入 Map/Set/Heap 后不改变键的比较/哈希属性。不仅凭手写/derive 组合判错;普通集合逻辑错误与 unsafe 中的 UB 分开说明。来源:ORDEQHASH、KEYMUT、B-10。
- R07 编码与确定性:手写 Serialize 的字段/元素数和内容一致;身份、路径、授权判断不使用有损字符串转换或错误的前缀匹配;签名、哈希和要求可复现的输出不依赖随机迭代顺序。来源:SERFIELDS、LOSSYSTR、STRCMP、NONDET。
二、异步、并发和资源
- R08 执行器阻塞:检查同步 I/O、睡眠、锁竞争和长 CPU 工作是否阻塞 executor。按场景使用异步 API、专用线程或有并发上限的 spawn_blocking;考虑阻塞任务开始后通常不能通过 abort 停止。来源:ASYNCBLOCK、A-06、B-22。
- R09 锁范围和顺序:追踪 guard、DashMap 引用和临时值的实际生命周期,核对重复锁、ABBA、读升级写及回调重入。避免同步锁跨 await;Tokio Mutex 可跨 await,但仍须证明无循环依赖并控制持锁时长。来源:DLOCK、ABBA、REENTRANT、A-07、B-21。
- R10 同步原语与通知:条件变量谓词受锁保护并处理虚假唤醒;Once/Lazy 初始化不重入;通道保留的 sender 不得使接收端永久等待;普通 Tokio 信号任务不误判为 POSIX 信号处理函数。来源:CONDVAR、ONCEREENTRY、CHANSTARVE、REENTRANT。
- R11 原子性和线程边界:load/store 组合是否需要 CAS、锁或单写者保证;检查内存序、static mut、跨进程共享映射和 unsafe Send/Sync 的真实契约。编译器已经拒绝的调用不描述成可运行漏洞。来源:ATOMICRACE、UNSAFESYNC、SENDSYNCBOUND、SHMRACE、STATICMUT。
- R12 取消与部分进度:检查 select、timeout、abort、连接断开处每个 await 前后的状态和消息所有权。部分读写、取出后待发送、ACK 与提交之间须可恢复、回滚或幂等重试。pin 和“事务”命名本身不是证明。来源:CANCELSAFETY、A-09、A-10、A-11。
- R13 帧读取和公平性:read_exact/write_all 被取消时核查进度保存;换成 read 仍需维护帧边界和偏移。select 的默认/biased 选择按退出时限和公平性判断,避免持续就绪的工作饿死 shutdown 或反过来饿死必要收尾。来源:SELECTBIAS、CANCELSAFETY、A-10。
- R14 任务生命周期:每个长期 spawn 任务有 owner、退出信号、JoinError 和业务 Result 处理;丢弃 JoinHandle 通常是脱离管理,不是停止任务。等待、abort、超时和资源清理有可执行的顺序。来源:A-12、A-13、A-21、B-22。
- R15 背压和资源预算:检查输入长度、队列、缓存、去重表、重试、任务并发和日志量是否有上限及满载策略;评估 O(n²) 放大、失败重试风暴、内存/CPU/磁盘耗尽。来源:RESEXHAUST、A-21、B-28;磁盘与重试语义同时按 IDPS 运行约束核对。
- R16 深度和栈消耗:外部可控的递归结构在解析、Debug/Display/Serialize、日志和 Drop 各阶段都需检查深度;先核实库已有保护,再判断是否需要限深或迭代实现。来源:RECURSEDES、RECURSEFMT、RECURSEDROP。
- R17 资源所有权和落盘:文件描述符、连接、外部句柄有唯一明确的释放责任;exit/forget/ManuallyDrop 不绕过必要清理;重要 BufWriter 输出检查 flush 错误。flush 不等于断电持久化,按业务契约核查文件同步、原子替换和恢复。来源:RAWFD、DROPSKIP、BUFFLUSH、B-17、B-19;持久化要求见 I04。
三、unsafe、FFI 和系统边界
- R18 安全封装的健全性:建立安全入口到 unsafe 的调用路径。安全接口通过类型、封装或实际检查保障前置条件;unsafe fn 明确调用者义务。安全函数不能只写 Safety 注释就转嫁义务。来源:URAPI、SAFETYDOC、A-04、B-23。
- R19 release 下的安全条件:不能依赖会被关闭的 debug_assert、只在测试成立的范围或只在某 feature 下存在的检查保护 unsafe。来源:DEBUGSAFETY、A-05。
- R20 初始化、容量和析构:核对 MaybeUninit、set_len、from_raw_parts、ptr::write/read;所有被当作 T 访问/析构的元素已初始化,len 不超过有效元素。防止向未初始化槽位赋值触发旧值析构。来源:UNINITREAD、SETLEN、INVFREE、BOF。
- R21 指针与表示:核对存活期、分配来源、别名、对齐、复制重叠、访问范围、transmute、枚举判别值和 union 有效位模式;胖指针元数据不能在后续操作需要时丢失。指针转换本身不等于 UB。来源:TRANS、RAWPTR、PTRCAST、REPRC、ENUMUB、UNIONUB、PACKEDREF。
- R22 释放与 unwind 安全:裸指针不悬垂,同一资源不重复释放;用户闭包 panic 或容器更新中断后,已初始化计数和析构路径仍正确。安全 trait 返回的不可信长度不能直接驱动 unsafe 访问。来源:UAF、DFREE、PANICUNWIND、TRAITADV、CLOSUREPANIC。
- R23 FFI 契约:Rust/C ABI、布局、宽度、目标平台和库版本一致;CString/opaque handle/回调捕获持续有效;分配与释放配对;不直接传不稳定 trait object ABI 或对象 padding 作为协议字节。来源:ABIMISMATCH、CSTRDANGLE、OPAQUEPTR、FOREIGNDROP、DYNFFI、REPRCPAD。
- R24 FFI panic 和回调退出:明确跨边界的 unwind/abort 策略,不能假定 catch_unwind 捕获 abort。回调注销、在途调用和对象释放顺序可证明,无已释放状态的迟到访问。来源:CLOSUREFFI、B-24。
- R25 路径和文件竞态:外部路径不能通过绝对路径、..、符号链接越界;检查后使用的路径不被替换,结合原子创建、目录/文件句柄和权限设计。来源:PATHJOIN、TOCTOU。
- R26 敏感信息和地址暴露:日志、Debug、错误、序列化输出不泄露密钥、token、敏感载荷;运行时地址输出按接收方权限和可利用性评估。来源:PTREXPOSE、A-23、B-09、B-20。
四、API、维护成本、构建和测试
- R27 领域类型和构造:需要区分的单位/ID 使用明确类型;enum/Option 表达状态;集中校验跨字段约束。多个 bool、公开可变字段或复杂构造仅在易误用/破坏不变量时提出具体建议。来源:A-20、B-07、B-11、B-12。
- R28 所有权和借用:参数与返回值符合只读、修改、保存的需求;评估重复 clone、Arc/RefCell 和复杂生命周期的真实成本。共享 actor 状态、缓冲复用、明确的拥有结果不因写法偏好被重构。来源:A-01、A-02、A-03、B-04、B-05、B-06。
- R29 公共 API 演进:检查可见性、trait 契约、第三方类型暴露、返回类型和 non_exhaustive/sealed 的兼容影响;更改前搜索调用者、协议和持久化消费者。来源:B-08、B-09、B-12、B-14。
- R30 抽象与重复逻辑:指出有实际错误风险或同步维护成本的重复;trait/泛型/dyn/宏按实际多态和编译体积需求取舍,不为消除所有重复新增框架层。来源:A-18、B-01、B-13、B-18;跨仓复用见 I07。
- R31 性能建议需要依据:核对热路径的 collect、分配、clone、每条日志和逐项加锁;优先解释复杂度或提供测量证据,再建议批量、缓冲复用或容量优化。不要一律替换分配器/hasher 或把循环改迭代器。来源:A-16、A-17、B-20、B-28。
- R32 文档与可理解性:文档说明错误、Safety、取消、所有权及副作用;说明不变量为何成立。命名、导入、Builder 与语法偏好归为建议,不掩盖真实缺陷。来源:SAFETYDOC、A-20、B-18、B-20、B-26。
- R33 Cargo 和 MSRV:edition、rust-version、编译器、依赖 API 与 features 一致;核对 host/Android 差异和 workspace 继承,不因本机新编译器通过就声称 MSRV 通过。来源:MSRV、A-08、B-25。
- R34 lint 与依赖配置:读现有 Cargo/Clippy/CI 设置后判断安全 lint 是否被错误关闭;已有 unsafe 的边界 crate 不强制 forbid(unsafe_code),未开 pedantic 不判缺陷;核查有实际风险的弃用/不稳定 API。来源:CARGOLINT、DEPRECAPI、B-02、B-03、B-25。
- R35 失败和边界测试:检查非法输入、零/最大长度、溢出、超时、断连、队列满、磁盘失败、任务退出和取消后恢复;回归场景应在旧实现暴露缺陷,而非复述实现。来源:A-20、A-21、B-27。
- R36 可重复测试和性质:时间、随机、网络、路径可控制;测试不互相污染。对编解码、持久化状态和重复事件检查往返、幂等和不变量,避免用固定 sleep 假设完成。来源:B-27;测试隔离同时遵循 IDPS 既有测试规范。
- R37 按风险选工具:格式/lint/测试使用现有 Makefile;解析器考虑 fuzz,unsafe 考虑 Miri,跨平台代码检查目标配置。未运行或不支持时明确写出限制;这些工具不能证明业务语义全部正确。来源:B-02、B-24、B-27。
- R38 报告可操作性:每项引用规则、位置和证据;解释触发条件与影响并给最小修复及回归场景。合并同根因重复,不强行固定发现数量;区分确定性和严重度。来源:B-29、Trail of Bits 各检测器的条件与误报排除说明。
五、IDPS 项目规则
以下来自当前工作区规范及 idps-server 运行契约,不宣称来自上述三个上游仓库。
- I01 生产错误处理:生产代码禁止 unwrap/expect;应用层使用 anyhow/context,需结构化匹配的领域错误使用 thiserror。测试中的 unwrap/expect 按测试用途判断。
- I02 actor 生命周期:沿用现有 cloud/config/listener/register/report/rule 分工,以受控任务和消息传递表达长期子系统;检查启动失败、断连重连、退出、残留发送者和在途消息,不新增平行顶层架构。
- I03 本地与云端语义:本地接受/回应与云端确认分开,不能用云端暂时不可达阻断既定本地响应,也不能把本地接受冒充云端交付。保持组件与 VSOC 的字段、帧、鉴权和消息语义兼容。
- I04 持久化与重试:/etc/idd 为配置/随包资产,/data/idd 为运行状态;检查失败、重启和重复上报下的落盘、ACK、重试、去重及规则切换一致性,防止先删后发或错误确认造成数据丢失。
- I05 日志和安全边界:使用 tracing,敏感载荷/密钥不进日志;TLS、身份和密钥轮换符合已有契约;不要提出绕过 Android SELinux neverallow 的修复。
- I06 工具链和验证范围:根自动化使用 rustup run 1.93.0,仍需尊重各 Cargo.toml 的 MSRV;idps-server 的根入口为 make check project=server。协议或 idps-base 公共 API 变化需覆盖下游,并按影响选择集成/设备验证;本清单的提取本身不代表已执行扫描或这些检查。
- I07 共享逻辑与维护:跨组件核心行为优先复用 idps-base;保留明确产品差异和协议兼容处理。只在证实重复维护成本或正确性风险时建议提取,避免无必要的重构。
项目来源:工作区根 AGENTS.md/CLAUDE.md,idps-server/AGENTS.md/CLAUDE.md、idps-server/docs/architecture.md、idps-server/docs/detailed-design.md,以及既有 Rust 代码审查规范(原始资料路径:../rust-code-review.md)。扫描时以目标分支实际文件为准。