代码即文档：逻辑清晰、规范至上的AI安全实践

　　我原以为是WAF策略被绕过了，结果抓包盯了三小时，发现是同一个接口在十二个不同模块里各自实现了三次鉴权逻辑——两处跳过、一处写死token、还有一处把风控结果当布尔值用，但返回的是字符串“0”和“1”。

　　防火墙日志一直在刷，绿色滚动条根本停不下来，运维老张端着保温杯凑过来瞄了一眼，说“这流量看着不像扫描，倒像自己人刷的”，转身就去调数据库连接池参数了。我没拦，反正他也拦不住那个正在跑的定时任务——它每五分钟重载一次配置，而配置里那行注释写着：“此处临时关闭签名校验（上线后删）”，时间戳是去年十一月。

　　2025年7月那阵子，攻击不是连续的，是一阵一阵的，像有人蹲在暗处听你敲键盘的节奏。前半夜打进来试探权限，后半夜才真正动数据。我们追着IP链路往回捋，最后卡在AI服务网关的一层装饰器上：它名义上做请求脱敏，实则把原始payload塞进了上下文对象的私有字段里，然后被下游三个模块分别用三种方式反序列化——有一个居然用eval()拼接字段名，还是用的f-string。我说出来的时候，同事小林直接把耳机摘了，对着天花板翻了个白眼：“又是这个。”

　　手机一直在震，是业务方王经理第三次发来截图，说“客户反馈导出报表失败”，底下附了条语音：“你们那个模型服务是不是又崩了？要不先切回旧版？”我点开语音听第二遍时，窗外天亮了，路灯自动熄灭那瞬间，突然意识到——旧版压根没接风控模块，所有校验全靠前端藏一个disabled属性。没人记得这事，因为半年前交接文档只写了“前端控制入口可见性”。

　　代码即文档：逻辑清晰、规范至上的AI安全实践。这话现在听着不刺耳了，不是因为变信了，是因为真见过谁活下来了。就上个月，隔壁组两个应届生重构了特征注入模块，硬生生把原来四百行嵌套回调塞进七十行类型安全的pipeline里。上线第三天，红队扫出个路径遍历——但没利用成，因为他们用的统一路径解析器早把../给normalize成空了。不是靠WAF拦截，是压根构造不出有效路径。当时我盯着那行`os.path.normpath()`看了五分钟，心想：这玩意儿连文档都不用写，它自己就是说明书。

　　泡面凉了，在桌角结了一层膜，我懒得动。其实早该扔了，但一动就怕打断正调试的断点。那个装饰器里还藏着一段废弃逻辑，用来兼容某次POC验证用的测试密钥，密钥字符串硬编码在类方法里，base64过但没加盐——我们后来查日志才发现，最早那次异常调用，就是有人用那段密钥的明文哈希撞上了签名验证的短路判断。我原以为是算法缺陷，结果是人忘了删代码。删掉之后，日志清净了三天。

　　跟业务方吵那一架，起因是他坚持要在AI推理API里加个“管理员开关”，允许手动覆盖模型决策结果。我说“你开个开关，等于把熔断器换成胶带”，他笑：“你们安全不就爱搞胶带么？贴一层再贴一层。”我噎住，因为我刚帮他改完第七版密码策略——他上回写的弱口令校验逻辑，把“password123”判成强密码，因为正则里多了一个问号，把整个量词弄反了。我改完那天，他请我吃了顿饭，结账时发现他手机锁屏壁纸是“root:admin”，还配了个小字：“测试环境，放心”。我夹了块豆腐没说话。

　　最麻的是复盘会上没人提那三行注释。大家围着traceID看链路延迟，分析GC停顿，计算QPS阈值，连日志采集丢了七秒都记了页眉。可就没人打开IDE，搜一下那个装饰器类里的“// TODO remove before prod”——它在第89行，从2023年就躺在那儿，和旁边一行被注释掉的JWT解码密钥并排，像一对守灵人。我截图发群里，过了二十分钟，小林回：“哦，那个啊，当时上线压测太急，说是‘下周删’，后来就没下周了。”语气平淡得像在说天气。

文章配图，仅供参考

　　昨天工单系统弹窗，提示“用户上传文件触发敏感词检测超时”，点开一看，是某个新接入的第三方SDK把整份PDF读进内存再分词。我本来想写个“建议优化流式处理”，鼠标悬停在输入框上三秒，删了，改成“已禁用该SDK默认加载策略，强制走沙箱进程隔离”。提交前补了句：“文档补在config.py第42行注释里了，别删。”

　　反正现在写代码，第一反应不是“怎么防住”，而是“谁以后会读这段”。读的人要是我自己，我就得少骂自己两句；要是新人，我就得让ta十分钟内搞懂为啥这里return false比throw exception更安全；要是红队，……算了，红队爱怎么看怎么看吧。代码自己会说话，只是以前我们总捂着它的嘴，逼它用注释、用wiki、用飞书文档翻译自己。现在？让它自己讲。讲不清的，就淘汰。

　　下礼拜得补个lint规则，检查所有装饰器里有没有未清理的print()语句——上回就是靠这个漏出来的。对了，还得问问运维，上次换的证书是不是还没续，因为日志里偶尔飘一句“SSL handshake timeout”，但我没往下追，今天太累了。

（编辑：站长网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!