字段丢失往往在映射规则设计阶段就已埋下：目标字段没有声明必填、来源值格式不合法被静默跳过、规则未覆盖的字段无人检查。本文按“字段清单—必填校验—类型校验—完整性检查”的顺序，说明如何把每条映射写成可校验的规则，并给出角色分工、完整示例与上线前检查清单，适用于研发数据迁移前的规则设计与试迁移验证。
要点总览（TL;DR）
- 映射规则以一份字段清单为唯一依据：每个目标字段声明来源、必填级别、类型与枚举范围、转换方式和失败处理，三类校验都从这份清单生成。
- 必填校验先分级（强制必填、条件必填、可空），再统一空值判定口径，把空字符串、null、占位符和系统默认值分别处理，条件必填写明触发条件与例外放行记录。
- 类型校验分基础类型、业务格式、枚举字典三层，未匹配值进入未匹配清单由业务方确认，转换失败按字段对业务判断的影响选择拒绝写入、置默认值或转人工复核。
- 完整性检查在单字段校验之外补三项：映射覆盖率、按对象类型的记录数对账、按字段抽样比对，差异清单逐条闭环后才进入上线判断。
- 上线前逐项确认清单覆盖、规则声明、失败明细处置、对账与抽样证据、变更记录和签认归档，任一项缺失回到对应环节补齐。
先建字段清单，再写映射规则
映射规则的载体是一份字段清单，它同时承担三件事：记录来源与目标的对应关系、声明每个字段的校验要求、作为试迁移和验收时的比对依据。清单先于规则存在，后续必填、类型、完整性三类校验都从这份清单生成，避免同一字段在不同环节出现两套口径。
清单建议按目标对象组织，每个目标字段一行，至少包含以下列：
| 列名 | 填写内容 | 示例 |
|---|---|---|
| 目标对象/字段 | 目标系统中的对象名与字段名 | 工作项.优先级 |
| 来源对象/字段 | 来源系统中的对应位置，无来源时标注“无” | 问题.Priority |
| 必填级别 | 强制必填、条件必填、可空 | 强制必填 |
| 允许为空条件 | 条件必填时写明触发条件 | 仅当状态为“已关闭”时允许为空 |
| 来源类型/目标类型 | 基础类型声明 | 文本 → 枚举 |
| 格式与枚举范围 | 日期格式、长度上限、字典值列表 | 低/中/高/紧急 |
| 转换方式 | 直接复制、字典映射、公式转换 | 字典映射 |
| 失败处理 | 拒绝写入、置默认值、转人工复核 | 转人工复核 |
清单完成后由业务方逐字段确认含义与必填级别，确认后的版本作为唯一依据冻结，后续修改走变更记录。完成标志是：每个目标字段都有明确来源或明确标注“无来源”，且必填级别与类型声明无空缺。
必填校验怎么设：分级与放行条件
必填校验拦截的是“该有值却没有值”。设置时先分级，再统一空值判定口径，最后为条件必填写明放行规则。
必填级别定义
| 级别 | 含义 | 校验行为 |
|---|---|---|
| 强制必填 | 任何记录都必须有值 | 为空即判定失败，阻止写入 |
| 条件必填 | 满足特定条件时必须有值 | 条件成立且为空时判定失败 |
| 可空 | 允许无值 | 不拦截，但计入完整性统计 |
空值判定口径
同一字段在不同环节判定不一致，是必填校验失效的常见原因。清单中需明确以下四类情况是否算“空”：
- 空字符串与纯空格：统一按空处理，写入前先做去空格。
- null 与字段缺失：均按空处理，来源导出时区分“字段不存在”和“值为空”两种情况并分别记录。
- 占位符：如“-”“无”“N/A”“待定”，需在清单中列出占位符清单，命中即按空处理，避免占位符冒充有效值。
- 默认值：来源系统自动填充的默认值（如默认优先级“中”）应标记为“系统默认”，与人工填写值区分，供业务方判断是否可接受。
条件必填的触发与放行
条件必填要写清触发条件，例如“状态为已解决时，解决结果必填”。条件成立但值为空时，规则判定失败并生成失败记录，记录中带上记录标识、字段名、触发条件和实际值。确需放行的，走例外登记：写明字段、记录范围、放行理由和批准人，例外清单随迁移报告一并留存。失败记录的处置只有两种结果——修正来源数据后重跑，或登记为例外，不允许直接忽略。
类型校验怎么设：类型、格式与枚举
类型校验拦截的是“有值但不合法”。这类问题比空值更隐蔽：值看起来存在，写入目标系统时因格式不符被丢弃或截断，形成隐性丢失。校验分三层设置。
基础类型校验
| 目标类型 | 校验内容 | 常见失败情形 |
|---|---|---|
| 文本 | 字符集、长度上限 | 超长被截断、含不可见字符 |
| 数值 | 是否为数字、小数位、取值范围 | 带单位或千分位分隔符 |
| 日期 | 格式、时区、有效日期 | 格式混用、时区偏移导致日期错位 |
| 布尔 | 取值集合 | 来源用“是/否”“Y/N”等多种写法 |
格式校验
在基础类型之上补充业务格式：日期统一到目标系统要求的格式并声明时区基准；编号类字段校验前缀与位数规则；文本字段声明长度上限，超长时明确是截断并记录，还是拒绝写入转人工处理。格式规则写在清单的“格式与枚举范围”列，与类型声明放在一起。
枚举与字典值校验
来源与目标的枚举值往往不是一一对应。做法是先建立字典映射表，列出来源每个取值对应的目标取值；校验时逐条比对，未匹配的值不静默丢弃，而是进入未匹配清单，由业务方确认是新增映射、映射到默认值，还是保留原值写入备注字段。映射表本身也要版本化，试迁移后如有调整，重跑时使用同一版本。
转换失败的处理
每条规则都要声明转换失败时的动作：拒绝写入并记录、置为默认值并标记、或转人工复核。三种方式的选择依据是字段对业务判断的影响程度——影响统计与流程走向的字段（如状态、优先级）宜转人工复核，纯描述性字段可置默认值并标记。失败记录至少包含来源记录标识、字段名、原始值、失败原因和建议处理方式，作为试迁移阶段逐条修正的输入。
完整性检查：覆盖率、对账与抽样
单字段校验只能检查已写进规则的字段，规则之外的遗漏需要整体检查兜住。完整性检查包含三项，按执行顺序排列。
映射覆盖率检查
对照目标系统的字段定义，逐一确认每个目标必填字段在清单中都有来源或明确的“无来源”说明。覆盖率按“已声明来源的目标必填字段数 ÷ 目标必填字段总数”计算，未覆盖的字段单独列出，由业务方决定补映射还是确认可空。这项检查在试迁移之前完成，成本最低。
记录数对账
迁移前后比对记录数量：来源对象的总条数、通过校验写入的条数、被拦截的条数、登记为例外的条数，四者应能对上。按对象类型分别对账，例如工作项、评论、附件各算一组。数量对不上时，先定位是拦截还是写入环节丢失，再回到失败明细排查。
抽样比对
按字段逐项核对取值，样本覆盖不同对象类型、不同状态和边界值记录。抽样时重点看三类字段：经过转换的字段（枚举映射、日期格式）、条件必填字段、以及来源中存在占位符的字段。抽样结果记录“来源值—目标值—是否一致”三列，不一致的进入差异清单。
差异清单格式
| 列名 | 说明 |
|---|---|
| 差异编号 | 唯一标识，便于跟踪闭环 |
| 对象/记录标识 | 定位到具体记录 |
| 字段名 | 差异所在字段 |
| 来源值 / 目标值 | 两侧实际取值 |
| 差异类型 | 缺失、格式不符、枚举未匹配、截断 |
| 处理方式 | 修正来源、调整规则、登记例外 |
| 状态与责任人 | 待处理、已修正、已确认 |
差异清单是试迁移的核心产出，每条差异要么修正后重跑验证，要么登记例外并说明理由，清零或全部登记后才进入上线判断。
角色分工与各环节交付物
映射规则涉及业务含义判断和技术执行两类工作，分工不清会导致必填级别随意调整、失败记录无人复核。建议按以下方式划分。
| 角色 | 职责 | 交付物 | 交接时点 |
|---|---|---|---|
| 业务方（字段负责人） | 确认字段含义、必填级别、枚举映射的业务取舍 | 字段清单确认版、字典映射表确认版 | 规则编写前 |
| 迁移执行方 | 编写与维护映射规则、执行校验、输出失败明细与差异清单 | 映射规则文件、试迁移报告、差异清单 | 试迁移后 |
| 数据复核人 | 复核失败明细处置、例外登记、抽样比对结果 | 复核记录、例外清单签认 | 上线前 |
| 项目负责人 | 确认差异清零或例外可接受，批准上线 | 上线确认记录 | 切换前 |
规则变更要有记录：谁改、改了什么字段、依据是什么。业务方确认后的清单冻结版本，执行方不得自行调整必填级别或枚举映射；确需调整时回到业务方确认，再更新版本号。
在规则维护和结果复核环节，可以把字段清单、字典映射表、差异清单作为文档统一管理，失败记录以工作项形式分派给字段负责人，处理状态与差异清单保持同步。ONES 的迁移方案围绕项目、工作项、状态、字段、流程、附件和历史记录进行，并把数据完整作为迁移目标之一；字段级校验规则的具体配置方式以实际迁移工具和实施方案为准，上述清单与差异记录可在其文档与工作项管理中承载，便于复核人按字段追踪闭环。
示例：一条工单字段映射规则的完整写法
以下为演示情景，展示一条规则如何同时写清必填、类型与完整性要求。
映射对象：来源“问题.优先级” → 目标“工作项.优先级”。
- 必填级别：强制必填。空字符串、null、占位符（“-”“无”“N/A”）均判定为空；来源系统默认值标记为“系统默认”，需业务方确认是否接受。
- 类型与枚举：来源为文本，目标为枚举。字典映射为：Highest→紧急、High→高、Medium→中、Low→低、Lowest→低。未匹配值不丢弃，进入未匹配清单。
- 转换与失败处理：字典映射成功则直接写入；未匹配时转人工复核，记录来源记录标识、原始值、失败原因，由字段负责人确认新增映射或映射到默认值“中”并标记。
- 完整性要求：该字段计入映射覆盖率检查（目标必填字段，必须有来源）；试迁移后按状态分层抽样，核对来源值与目标值一致；差异进入差异清单，按“枚举未匹配”类型跟踪至闭环。
这条规则的写法可以直接套用到其他字段：必填级别与空值口径、类型与枚举声明、失败处理动作、完整性检查归属，四部分齐全才算一条可执行规则。
完成检查：上线前逐项确认
上线前用以下清单逐项确认，每项都要有可查的记录，不以口头确认代替。
- 字段清单覆盖全部目标必填字段，无来源的字段已由业务方确认可空或补映射。
- 每个字段的必填级别、空值判定口径、类型与枚举范围均已逐字段声明，清单版本已冻结。
- 字典映射表覆盖来源全部实际取值，未匹配值的处理方式已明确。
- 试迁移失败明细已逐条处理：修正后重跑通过，或登记例外并写明理由与批准人。
- 记录数对账四组数字（来源总数、写入数、拦截数、例外数）能对上，按对象类型分别核对。
- 抽样比对结果已留存，差异清单中无“待处理”状态条目。
- 规则变更记录完整，最终版本与业务方确认版本一致。
- 复核人与项目负责人的签认记录已归档，作为切换依据。
以上各项全部满足，说明映射规则已达到可执行状态；任一项缺失，应回到对应环节补齐后再进入正式迁移。
常见问题
来源系统导出的字段本身就不存在，和字段有值但为空，处理方式要区分吗？
要区分。字段缺失说明来源侧没有这个属性，可能是导出范围没包含，也可能是来源系统本来就没有该字段；值为空则是字段存在但没有填写。两者在必填校验里都按空处理，但记录方式不同：字段缺失应回到来源导出环节确认是否漏导，值为空则进入失败明细由字段负责人判断是补数据还是登记例外。混在一起记录，后续排查时无法判断问题出在导出还是数据本身。
试迁移时失败明细很多，全部修正成本太高，可以按什么顺序处理？
建议按字段对业务判断的影响排序。影响统计口径和流程走向的字段（如状态、优先级、解决结果）优先修正，这类字段错了会连带影响报表和后续流转；纯描述性字段可以批量置默认值并标记，留待上线后补充。同一字段的失败记录可以按失败原因归并处理，例如枚举未匹配集中确认一次字典映射，比逐条修正效率更高。登记为例外的记录要写明字段、记录范围、理由和批准人，随迁移报告留存。
字典映射表在试迁移后调整了，重跑时怎么保证前后结果可比？
映射表要版本化。每次调整生成新版本号，记录改了哪些取值、依据是什么、由谁确认。重跑时明确使用哪个版本，试迁移报告里标注版本号，这样两次结果差异可以归因到映射调整而不是数据变化。业务方确认后的版本冻结，执行方不自行修改；确需调整时回到业务方确认再更新版本，避免同一批数据在不同轮次用不同口径校验。
记录数对账时四组数字对不上，一般先查哪里？
先按对象类型分别对账，定位到哪一类对象数量不一致，再区分是拦截环节还是写入环节的问题。来源总数与写入数加拦截数加例外数之差，通常来自三种情况：校验拦截后未计入拦截统计、写入过程中部分记录失败但未记录、同一记录被重复写入。先看失败明细是否完整，再看写入日志有无报错，最后核对是否存在重复导入。对账要按对象类型分组进行，工作项、评论、附件混在一起算总数会掩盖单类对象的问题。
业务方确认字段清单后，执行中发现某个必填级别设得不合理，能直接改吗？
不能由执行方直接改。必填级别影响哪些记录会被拦截，属于业务含义判断，调整要回到字段负责人确认，确认后更新清单版本号并记录变更原因。执行方可以提出调整建议并附上试迁移中的实际影响数据，例如该字段在多少条记录上触发拦截、其中多少属于来源数据问题，供业务方判断。清单冻结版本与最终执行版本不一致时，上线检查会通不过，所以变更必须留痕。
