必须主动脱敏日志中的API Key，禁止明文输出：Java用Logback PatternLayout正则替换或自定义Filter，Python用logging.Filter递归检测替换，Go用zap封装MaskedAPIKey字段构造器。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在火山引擎应用日志中防止完整 API Key 泄露，必须对日志输出内容做主动脱敏，不能依赖事后审计或人工排查——因为日志一旦落盘且含明文密钥，就已构成安全违规，且不可逆。
识别日志中可能泄露密钥的代码位置
打开项目中所有涉及日志打印的文件（尤其是 error、info 级别日志），重点扫描：logger.info()、log.Printf()、console.log() 等调用；搜索关键词 apiKey、api_key、AK、accessKey、credentials。
特别注意拼接字符串日志：比如 logger.info("call api with key: " + apiKey)——这种写法会直接把原始值塞进日志，必须改掉。
【不修改此处，后续所有脱敏操作都无效】
Java 项目中使用 Logback 实现自动密钥脱敏
方法一：通过 PatternLayout 配合正则替换
在 logback-spring.xml 的 <appender></appender> 内，将 <layout></layout> 替换为：
该正则会匹配大小写不敏感的密钥关键词后紧跟的 20 位以上 Base64 字符串，并统一替换为 ***REDACTED***。
方法二：自定义 Filter 做精准字段拦截（推荐）
新建类 ApiKeyMaskingFilter 继承 ch.qos.logback.core.filter.Filter，重写 decide 方法，在日志事件的 formattedMessage 中执行 replaceAll，匹配模式同上；再在 logback-spring.xml 中注册该 Filter 到 appender 下。
此方式比 PatternLayout 更可靠——它作用于格式化后的最终消息，不受占位符（如 {}）干扰，避免漏脱敏。
Python 项目中拦截并覆盖敏感字段
第一步：在日志配置前插入脱敏处理器
使用 logging.Filter 子类，在 filter(record) 中对 record.msg 和 record.args 递归遍历，检测是否含密钥特征字符串或长度超长的 Base64 值（如 ^[A-Za-z0-9+/]{32,}={0,2}$）。
第二步：对疑似密钥字段执行掩码替换
不要只截取前缀后缀，而应整体替换为固定掩码字符串，例如 "ak-********-****-****-****-************"——这能防止通过长度反推密钥类型。
第三步：确保该 Filter 被添加到 root logger 或对应 handler
调用 logging.getLogger().addFilter(ApiKeyMaskFilter())，且必须在 basicConfig 或 dictConfig 之后执行，否则不生效。
Go 项目中使用 zap 日志库的安全写法
禁止使用 zap.String("api_key", apiKey) 直接传参——这会让密钥原样进入结构化日志 JSON。
正确做法是：封装一个脱敏字段构造器
func MaskedAPIKey(key string) zap.Field {<br> if key == "" { return zap.String("api_key", "") }<br> return zap.String("api_key", "ak-********-****-****-****-************")<br>}
调用时写成 logger.Info("calling upstream", MaskedAPIKey(apiKey))。
这一步必须手工替换所有日志调用点，zap 不支持全局正则过滤器，无法靠配置自动完成。
