4、单参数传递模型：参数定义、参数作用域（全局/局部）、参数生命周期、参数与上下文绑定
在审查意见与审批工作流中，单参数传递模型是保证流程节点间数据一致性与可追溯性的核心机制。一个参数从定义到销毁，经历了定义、作用域约束、生命周期管理以及上下文绑定四个阶段。本章将逐一拆解这些阶段，并给出工程实践中的最佳策略。
4.1 参数定义：类型、名称与默认值
参数定义是传递模型的起点。每个参数必须明确其数据类型、唯一名称以及默认值。在审批工作流中，常见的参数类型包括：
| 参数类型 | 示例 | 说明 |
|---|---|---|
| 字符串 | approver_comment |
审批意见文本 |
| 布尔值 | is_approved |
审批通过/拒绝标志 |
| 数值 | priority_level |
优先级（1-5） |
| 对象 | attachments |
附件列表（JSON） |
| 枚举 | review_action |
同意/驳回/转办 |
工程建议：参数名称采用小驼峰命名法（如
reviewerId），避免使用中文或特殊字符。默认值应选择“空”或“无操作”语义，防止未赋值时流程异常中断。
4.2 参数作用域：全局与局部
作用域决定了参数在流程中的可见范围。单参数传递模型严格区分两种作用域：
- 全局参数（Global）：在整个流程实例中可见，所有节点均可读写。适用于流程级上下文，如
申请单号、发起人。 - 局部参数（Local）：仅在当前节点或子流程内可见，节点结束后自动销毁。适用于节点内部临时数据，如
当前审批人意见。
下表对比了两者的关键差异：
| 维度 | 全局参数 | 局部参数 |
|---|---|---|
| 可见范围 | 整个流程实例 | 当前节点/子流程 |
| 生命周期 | 流程实例创建到结束 | 节点进入到离开 |
| 存储位置 | 流程实例上下文 | 节点执行上下文 |
| 典型用途 | 业务单据号、发起人 | 审批意见、临时计算值 |
| 冲突风险 | 低（命名空间隔离） | 高（同名覆盖需谨慎） |
避坑指南：不要将敏感数据（如密码、）存储在全局参数中。局部参数应避免与全局参数同名，否则在节点内访问时，局部参数会屏蔽全局参数，导致数据丢失。
4.3 参数生命周期：从创建到销毁
每个参数都遵循一个完整的生命周期，理解这一周期有助于设计健壮的参数传递逻辑。下图展示了单参数在审批流程中的典型生命周期：
生命周期各阶段的关键操作：
- 定义：在流程设计时声明参数元数据（名称、类型、默认值、作用域）。
- 赋值：在节点执行时写入值，可通过表单输入、系统计算或上游传递获得。
- 传递：参数从一个节点流向另一个节点，可能经过数据转换或映射。
- 使用：下游节点读取参数值，用于条件判断、审批意见展示或业务逻辑。
- 销毁：局部参数在节点结束时自动回收；全局参数在流程实例结束时回收。
4.4 参数与上下文绑定
参数不能孤立存在，必须与执行上下文绑定才能发挥作用。上下文是参数运行时的环境容器，包含流程实例ID、节点ID、执行时间、操作人等元信息。绑定机制确保参数在正确的范围内被解析和传递。
下图展示了参数与上下文的绑定关系：
绑定实现要点：
- 显式绑定：在节点输入/输出映射中声明参数来源与目标，避免隐式依赖。
- 上下文隔离：每个节点拥有独立的局部上下文，防止数据污染。
- 快照机制：在参数传递时对值进行快照，确保历史版本可追溯。
- 绑定校验：在流程启动时校验所有必需参数是否已绑定，提前发现缺失。
4.5 工程实践：参数传递模型设计清单
在实现单参数传递模型时，建议遵循以下检查清单：
| 检查项 | 要求 | 验证方式 |
|---|---|---|
| 参数定义完整性 | 每个参数必须有名称、类型、默认值 | 设计时静态检查 |
| 作用域正确性 | 全局参数不包含节点临时数据 | 代码审查 |
| 生命周期闭环 | 局部参数在节点结束时释放 | 内存分析工具 |
| 上下文绑定一致性 | 参数来源与目标类型匹配 | 运行时类型检查 |
| 命名冲突检测 | 局部参数不与全局参数同名 | 自动化 lint 规则 |
常见陷阱：在分布式工作流引擎中，参数传递可能跨越服务边界。此时需要序列化参数为 JSON/Protobuf，并确保跨服务传递时上下文 ID 不丢失。建议使用分布式追踪 ID 作为全局参数的组成部分。