技术债风险识别：遗留系统、未文档化接口、已离职开发者

技术债风险识别

遗留系统、未文档化接口、已离职开发者本文档提供：三类债分流判定表1张；遗留系统画像表1张；未文档化接口画像表1张；离职开发者知识缺口表1张；统一风险画像登记表1张；优先级指数式(1)及变量定义表1张；优先级排序表1张；排查表1张（含三条检查点）；决策规则6条与矛盾四段1处；完整示例1个（含四次试错与变量表）；三套场景操作序列表1张；来源说明表1张。2026-11-03这一节的标题读完你能拿到什么这一节在全文中的功能一、先把债分成三堆：系统、接口、人，分不清的进第四堆三类债分流判定表（表1），逐行填载体、判断依据、分流去向确定第一动作，防止三类债混在一张清单里排序二、遗留系统看五个字段：上线年数、故障次数、提交间隔、依赖状态、替代方案遗留系统画像表（表2），含“画像是否完整”列给出遗留系统这一类债的字段口径与不完整处理三、未文档化接口先要调用方清单，文档最后写未文档化接口画像表（表3），含调用方数量与获取路径列把接口债从“缺文档”转成“影响面可数”的行四、离职开发者留下的缺口查三处：交接记录、工单处理人、提交记录离职开发者知识缺口表（表4），含当前在职掌握人数列给出知识集中度这一列的取值来源五、三类债归到一张画像表：影响面、暴露月数、掌握人数、缓解措施统一风险画像登记表（表5）把三类字段统一成可排序的列，避免各建一套表六、先修哪一个：优先级指数式(1)与排序表优先级指数式(1)、变量定义表（表6）与排序表（表7）把画像表转换成可对照的修复顺序七、什么情况先补文档、什么情况先换人、什么情况接受不修决策规则6条与矛盾四段式给超出标准排序流程时的判断依据八、排查从最近一次故障记录开始：三条检查点定位三类债排查表（表8），含三条可直接打开记录核对的检查点给出排查动作序列与标准值九、一次完整的识别：从系统清单到优先级清单完整示例，含起点、分步操作、四次试错、终点与变量表（表9）展示规则在真实操作顺序中的落地过程十、三套场景操作序列：完整版、精简版、极简版三套版本检查项与产出增减对照表（表10）按交付对象选择执行深度按第一列在正文找对应那节，按第二列判断这节有没有你要的东西，按第三列判断这节是否对应你当前卡住的位置。季度修复排期会上，桌上有一份系统清单、一份接口清单、一份离职人员记录，三份材料各编各的号：系统清单按业务域排，接口清单按协议排，离职记录按部门排，没有人能把“某系统里那个没人懂的接口”对应成一行，排期会上只能按部门轮流报。一、先把债分成三堆：系统、接口、人，分不清的进第四堆打开系统清单第一行，看“维护状态”列和“最近变更”列，再打开接口清单看“说明文档”列，最后打开离职记录看“交接材料”列。分流的判断依据是债的载体在哪：载体是系统本身进第一堆，载体是两个系统之间的调用进第二堆，载体是某个人的知识进第三堆。三处都对不上的进第四堆“载体待定”。表1三类债分流判定债编号载体在哪判断依据（看哪个文件的哪一列）分流去向分流动作分不清时怎么办D-01订单系统本身系统清单第5行“最近变更=2021-06”第一堆：遗留系统进表2填五个字段不适用D-02订单系统到报表平台的调用接口清单第8行“说明文档=无”第二堆：未文档化接口进表3填调用方数量不适用D-03对账模块的设计知识离职记录第12行“交接材料=仅账号清单”第三堆：离职开发者缺口进表4填当前在职掌握人数不适用D-04批处理脚本的维护责任系统清单无该脚本，接口清单无该脚本，离职记录无对应模块第四堆：载体待定标“待定”，一周内定载体按脚本所在主机找归属系统表1第4行是第四堆的示例：一个在定时任务里跑的对账脚本，三份材料都没有它。处理动作不是猜，是给一周时间定载体，定不出载体的脚本在优先级排序时按“影响面未知”单独列，不并入三类债的任何一堆。分流完成的标准是三类债各自有行、第四堆有明确时限。某一类一行都没有时，回到对应清单重查，不默认该类无债。二、遗留系统看五个字段：上线年数、故障次数、提交间隔、依赖状态、替代方案某订单系统上线11年，版本管理记录里最后一条功能提交在2021年6月，近12个月发生故障4次。五个字段填完之前，这一行不进入第五节的统一画像表。表2遗留系统画像债编号上线年数与最后功能提交距今月数近12个月故障次数与最长恢复时长依赖组件当前支持状态替代方案进展画像是否完整D-01订单系统11年；56个月4次；单次最长7.5小时运行环境版本已停止安全更新，仍在用已立项，完成需求评审，无上线时间不完整：替代方案无时间点D-05库存系统8年；31个月2次；单次最长3小时依赖组件在支持期内未立项不完整：替代方案未立项D-06结算系统13年；14个月1次；单次最长1小时依赖组件在支持期内已立项，计划本年度Q4切换完整表2第1行“画像不完整”的理由写具体缺哪一项，不写“信息不足”。第2行替代方案未立项，画像不完整；不完整的行在第五节标“画像待补”，不进入优先级排序，避免用残缺字段算出误导性的排序值。“依赖组件当前支持状态”一列写“在支持期内”“已停止安全更新”“厂商已终止支持”三档之一，依据是组件版本清单里的支持周期页。“替代方案进展”写四档：未立项、已立项无时间点、已立项有时间点、切换中。四档写不出时填“未知—需采集”。五个字段中，故障次数与最长恢复时长要能追溯到具体故障记录编号，追溯不上的按0次计并在备注列标“记录缺失”。三、未文档化接口先要调用方清单，文档最后写一个接口被几个系统调用、调用方里有几个是外部系统，这两个数决定接口债的影响面。文档缺不缺是次要判断，调用方数量拿不到的行不进入排序。表3未文档化接口画像债编号接口编号与两端系统调用方数量与获取路径调用方是否含外部系统最近一次变更距今月数画像是否完整D-02订单到报表IF-008；订单系统→报表平台3个；接口调用统计页按接口编号筛含1个外部对账服务22个月完整D-07库存到物流IF-021；库存系统→物流服务商未知；调用统计页无该接口记录未知9个月不完整：调用方未知D-08结算到财务IF-035；结算系统→财务系统1个；调用统计页可查无40个月完整表3第2行调用方数量填“未知”，原因是调用统计页没有该接口的记录，常见原因是接口走的是文件交换而非服务调用。这种情况不去猜调用方数量，画像标“不完整”，处理动作是补一次调用抓包或日志采集，采集完成前该行按“影响面未知”单独列。调用方数量从接口调用统计页按接口编号筛，筛不出时依次查网关日志、应用日志中的调用记录、文件交换目录的落地文件数。三条路径都查不到，标“调用方未知”，并在备注列写已查路径，避免下一个人重复查。“调用方是否含外部系统”一列直接影响排序：含外部系统的接口在第六节排序时影响面按实际调用方数加2计，理由是外部系统的变更协调周期长于内部。四、离职开发者留下的缺口查三处：交接记录、工单处理人、提交记录离职日期在人员记录里能查到，知识缺口的判断要看离职之后这个模块的事还由谁在做。三处各查一列：交接记录里有没有设计说明、近12个月工单处理人是不是原负责人、版本管理记录里近12个月有没有其他人提交。表4离职开发者知识缺口债编号模块与离职日期交接记录内容近12个月工单处理人当前在职掌握人数画像是否完整D-03对账模块2025-03离职仅账号清单，无设计说明原负责人离职后无人处理，工单挂起3次0人完整D-09报表模板2024-11离职有设计说明与参数说明由数据分析岗接手，处理14次1人完整D-10定时任务调度2025-08离职无交接记录由运维岗临时处理，处理2次1人，但只处理过告警不处理逻辑不完整：掌握程度未定表4第1行掌握人数为0，这一行在第六节公式里不代入，按规则3处理。第3行掌握人数填1人但备注“只处理过告警不处理逻辑”，这种行按“掌握程度待核”处理，核查动作是让该人员独立完成一次模块变更并记录耗时，核查完成前掌握人数按0.5计并在变量表备注。“当前在职掌握人数”的取值口径要统一：能独立完成该模块一次变更并说明设计意图的人数，只处理过告警或只重启过服务的人不计入。口径写在表4下方一行，不另设说明文档。三处查完后，交接记录内容为空且工单处理人已变更的行，判“缺口已转移”，转移给谁写进备注列；三处全空且掌握人数为0的行，判“孤儿模块”，在第五节单独标出。五、三类债归到一张画像表：影响面、暴露月数、掌握人数、缓解措施三类债各自的字段不同，排序前要压成同一套列。表5只保留五列加两个判定列，三类债逐行填入，不各建一套表。表5统一风险画像登记债编号类别影响面（个）暴露月数当前在职掌握人数当前缓解措施画像判定D-01遗留系统6个下游系统562有值班监控，无替代方案时间点画像待补D-02未文档化接口3个调用方，含1个外部221无接口说明，有调用日志可排序D-03离职开发者缺口4个下游报表80无，工单挂起可排序，按规则3D-07未文档化接口未知91无不可排序，影响面未知表5第4行画像判定“不可排序”，原因写影响面未知。不可排序的行不删除，单独列在排序表末尾，并附采集动作。第3行掌握人数为0，判定“可排序，按规则3”，意思是这一行进入排序但不代入式(1)。影响面一列三类债的口径不同，登记时按各自口径填并在类别列区分：遗留系统按下游系统数，未文档化接口按调用方数（含外部系统的按实际数加2），离职缺口按下游报表或下游业务数。口径不同不换算成同一单位，排序时靠式(1)的影响面分档处理，分档规则写进表6。暴露月数统一按“该债产生到本次评审的月数”，产生时点取三类债各自的最早可追溯记录：遗留系统取最后功能提交月，未文档化接口取接口上线月或最后变更月，离职缺口取离职月。六、先修哪一个：优先级指数式(1)与排序表画像表填完、可排序行确定后，用式(1)算优先级指数。算之前先把影响面分档，分档规则见表6的变量定义。式(1)优先级指数P表6式(1)变量定义变量含义取值来源常见错误校验方法PI优先级指数由式(1)算出把不同类别的PI直接比较而不看分档来源先看F档位再看PI值F影响面分档分表5影响面列按档换算：1—2个记2分，3—5个记4分，6个及以上记6分；含外部系统的向上取一档用原始个数直接代入手算一行核对档位T暴露月数表5暴露月数列用系统上线至今的月数代替追溯产生时点记录K当前在职掌握人数表5掌握人数列K填0直接代入导致除零K为0时按规则3处理，不代入式(1)的两个常见错误。第一，K为0时直接代入，算式无意义；正确做法是K为0的行不代入公式，按规则3走“孤儿模块”通道。第二，F用原始个数代入，一个影响面6个的遗留系统与一个影响面2个的接口直接比数值，分档后6个记6分、2个记2分，比较才有意义。校验方法。手里有表5的画像行和表6的档位规则，从排期会材料中拿到；算出的PI与上一季度同一债编号的PI对照，同时与本季度可投入的人日容量对照。PI上升但排期未变的行，检查是否F档位算错；PI下降但债未修的行，检查T是否被误改。表7优先级排序排序债编号类别F档位分T（月）K（人）PI本季度动作1D-03离职缺口480不代入，按规则3指定接管人并做一次独立变更2D-02未文档化接口6221132补接口说明并冻结变更窗口3D-09离职缺口212124季度抽查交接文档—D-07未文档化接口未知91不计算先补调用方采集表7第1行PI列写“不代入，按规则3”，不写一个编出来的数值。第4行不可排序的行放在表末，不参与名次。排序表每行“本季度动作”写一个可验收的动作，不写“加强管理”。七、什么情况先补文档、什么情况先换人、什么情况接受不修以下规则用于排序结果与实际情况冲突时的判断，每条写出触发条件和动作。规则1（画像待补先补画像）。如果表5某行画像判定为“画像待补”，则该行不参与本季度排序，补字段的动作排进本季度，补完后下季度重新排序。退路：连续两个季度补不齐字段的行，按现有字段的最低档代入F，并在排序表备注列标“低档代入”。规则2（影响面未知先采集）。如果表5某行影响面填“未知”，则先做调用采集或归属确认，采集动作本身排进本季度，该行不参与排序。退路：采集两次仍拿不到调用方数量的，按该类别影响面的最高档代入并标“高估代入”，防止被当作低风险漏掉。规则3（掌握人数为0的孤儿模块）。如果某行K为0，则该行不代入式(1)，直接排进排序表首位，动作写“指定接管人并完成一次独立变更”。退路：本季度指定不出接管人时，动作改为“冻结该模块变更，所有变更走双人复核”，排序仍保持首位。规则4（只处理过告警的掌握人）。如果某行掌握人数填了人但备注“只处理过告警不处理逻辑”，则掌握人数按0.5计，并附一次独立变更核查。退路：核查未通过时掌握人数改0，按规则3处理。规则5（同PI并列）。如果两行PI相同，则按F档位分高者排前；F也相同时，含外部系统的行排前。退路：两项都相同的，按债编号顺序排，不另行讨论。规则6（接受不修）。如果某行PI低于本季度排序表末位的三分之一，且该行近12个月无故障记录，则本季度动作写“接受，纳入下季度复评”，不投入修复资源。退路：下一季度该行PI上升超过三分之一时，自动回到排序表。矛盾四段。矛盾陈述：画像完整性要求每个字段可追溯，字段补得越全排期会开得越晚；排期会要求本季度就定下修复顺序，等不起所有字段补齐。实质分析：画像完整性服务排序结果的可靠性，排期时效服务本季度的资源投放，两者在“补字段还是先排序”上争时间；字段缺得越多，排序结论越依赖代入规则，代入规则用多了排序表就变成拍档表。权衡规则：影响面和掌握人数两列必须齐全才可排序，这两列直接决定修复动作是补文档还是换人；暴露月数和缓解措施两列允许缺，缺时按已有记录的最低值代入并标注。退路：本季度可排序行少于3行时，排期会只定“画像补齐”一项任务，修复排序顺延到下季度，不为了凑出排序表而降低字段要求。八、排查从最近一次故障记录开始：三条检查点定位三类债排查起点是最近一次故障记录，不是系统清单第一行。打开故障记录表，找到“故障模块”列，逐条与三张画像表比对。表8技术债识别排查表检查点在哪张表哪一行哪一列看什么算什么比什么标准值或参照物换哪条路故障模块是否在画像表表5“债编号”列，按故障记录的模块名逐行找数故障模块在画像表找不到对应行的条数大于0算漏识别按表1分流补入对应类，一周内补画像掌握人数是否为0表5“当前在职掌握人数”列数K为0且未排进排序表首位的行数大于0算排序异常按规则3回改排序表影响面是否未知表5“影响面”列数填“未知”且无采集动作的行数大于0算采集缺失补采集动作并写入本季度任务表8第1行的换路指向表1分流，第2行指向规则3，第3行指向规则2。三条检查点走完，产出三行排查结论，每行写“故障记录编号、检查点、判定结果、下一步动作”。九、一次完整的识别：从系统清单到优先级清单以下示例案例为合理设定，细节用于展示规则在操作顺序中的落地。起点。某企业季度修复排期会前三天，技术债审查人拿到系统清单（42个系统）、接口清单（68个接口）、离职记录（过去24个月11人离职），三份材料编号互不对应，上一次排期会按部门轮流报，报上去的修复项有7项在故障记录里找不到对应。分步操作与不顺利环节。第一轮。信号：把三份材料按业务域对齐时，有9个系统在接口清单里找不到对应接口，有4个接口在系统清单里找不到两端系统。当时以为接口清单漏了系统维度，准备按接口清单重编系统编号。试了重编后，42个系统变成51个，接口仍有4个对不上。试完发现对不上的不是编号是口径，接口清单按协议分组，同一系统在不同协议下重复出现，推翻了“编号对不上是清单漏项”的假设。换路：先用表1分流，按载体分三堆，不在编号层面强行对齐。第二轮。信号：分流后遗留系统17个、未文档化接口23个、离职缺口8个、载体待定3个。17个遗留系统填表2时，有11个的“替代方案进展”填不出。当时以为替代方案是规划部门的事，画像可以先空着。试了空着直接排序，排序表前五位有4个是替代方案未立项的系统，排期会上无法回答“修到什么程度算完”。试完发现替代方案字段决定动作可验收性，推翻了“替代方案属规划、不属技术债”的假设。换路：替代方案填不出的行标“画像待补”，按规则1不参与本季度排序。第三轮。信号：23个未文档化接口里，调用方数量能查到的只有14个，另外9个在调用统计页无记录。当时以为这9个是已废弃接口，准备直接标“低风险”。试了标低风险后，故障记录里恰好有一次故障发生在其中一个接口上，故障影响3个下游报表。试完发现无调用记录不等于无调用，推翻了“查不到就是没人用”的假设。换路：9个接口按规则2先采集，采集动作排进本季度，不标低风险。第四轮。信号：8个离职缺口里，K为0的有3个，其中1个是定时任务调度模块。当时以为掌握人数填1人就可以代入公式，理由是运维岗能处理告警。试了代入后PI算出来不高，排在排序表第7位。复核时发现该运维岗从未改过调度逻辑，只重启过服务。试完发现掌握人数的口径要收紧，推翻了“有人处理过就算掌握”的假设。换路：按规则4，该行掌握人数改0.5并附一次独立变更核查，核查未通过则改0，排序前移。终点。画像表可排序行19行，画像待补行7行，影响面未知行9行。排序表前三位：D-03对账模块（K=0，规则3，首位）、D-02订单到报表接口（F=6，T=22，K=1，PI=132）、D-10定时任务调度（K=0.5，核查中）。载体待定3个脚本一周内定出归属，其中1个并入遗留系统堆。表8三条检查点各填一行结论，故障记录中7项无对应画像的修复项补入画像表。表9示例中的关键变量与处置变化变量案例中情形如果变量不同处置变化可排序行数19行少于3行按矛盾退路只定画像补齐，排序顺延替代方案填不出的行数11/17占比低于30%不整体标画像待补，逐行按低档代入调用方数量查不到的接口数9/23超过半数采集动作升级为本季度首要任务，排序整体后移K为0的行数3行超过5行接管人指定改为批量指定，规则3动作加“结对变更”掌握程度待核的行数1行超过3行核查动作合并为一次集中评审载体待定条目数3个超过10个表1分流暂停，先做资产归属盘点变量表中权重较高的变量是“可排序行数”：它决定排期会是否只定画像补齐任务，其余变量影响的是单行动作类型和排序前移后移，不改变分流规则。十、三套场景操作序列：完整版、精简版、极简版选择依据：对外交付或年度技术规划走完整版；季度排期会且时间受限走精简版；岗位交接或新成员接手走极简版。三套版本按表10选择。表10三套场景的检查项与产出增减版本执行哪些步骤（对应表1至表8）保留产出去掉检查项不能妥协的底线完整版表1至表8全量，式(1)逐行计算三张画像表、统一登记表、排序表、排查表不删每行影响面与掌握人数齐全才排序；K为0的行不代入公式精简版表1、表5、表7，表2至表4只填本次排序涉及的行分流表、统一登记表、排序表非本次排序行的画像字段补全被跳过行标“本期未画像”，不默认低风险极简版表1分流、表5影响面与掌握人数两列分流简表、影响面与掌握人数两列登记暴露月数、缓解措施、式(1)计算影响面未知与掌握人数为0的行必须标