字节流层面明文脱敏是将脱敏嵌入数据流动管道，在解码过程中实时识别替换敏感信息，通过自定义InputStream/OutputStream、滑动缓冲区、Trie树字段边界识别及流式解码实现全链路无感、零格式改动的脱敏。
用自定义InputStream/OutputStream包装原始流
不依赖上层业务逻辑，直接对传输通道本身动刀：
- 继承
FilterInputStream或FilterOutputStream，重写read()/write()方法，在每次字节块进出时介入 - 内部维护滑动缓冲区（如
byte[4096]），按需解码为char或String（指定UTF-8或GBK编码） - 对解码后的文本片段执行轻量级匹配：比如检测连续11位数字+前后空格/引号/冒号，或字段名含
"phone""pwd"等模式 - 命中则原地替换为掩码字节（如
"***".getBytes(StandardCharsets.UTF_8)），未命中则透传
结合Trie树做流式字段边界识别
避免正则反复扫描、避免误伤JSON结构，靠前缀树对齐实际语义边界：
- 预加载敏感字段名（
"password"、"idCard"、"bankNo"）构建成Unicode兼容Trie树 - 在字节流解码为字符流过程中，同步推进Trie状态机：每读一个
rune就查一次节点，遇到isEnd=true且后续是:或=，即判定为字段头 - 一旦确认字段起始位置，向后贪婪读取值部分（跳过空白、引号），再对值内容单独脱敏（如手机号保留前3后4，银行卡号保留首4尾4）
适配主流IO场景，不破坏原有协议
脱敏必须透明，不能改格式、不能增删字节、不能影响校验：
- HTTP响应体输出：用
ServletOutputStream包装器，在write(byte[], off, len)中拦截，只处理Content-Type: text/*或application/json类响应 - 文件导出（如CSV/Excel模板生成）：将
FileOutputStream套一层脱敏流，按行缓冲+字段分割，对指定列做掩码，保持行列结构不变 - 数据库BLOB字段落盘：在JDBC
PreparedStatement.setBinaryStream()传入前，先经脱敏流处理，确保写入磁盘的是已处理字节
规避常见陷阱：编码、代理、副作用
企业级落地最易翻车的地方不在算法，而在细节：
立即学习“Java免费学习笔记（深入）”；
- 不做
new String(bytes)全量解码——会触发GC压力、产生临时大对象；改用CharsetDecoder.decode(ByteBuffer)流式解码 - 不调用DTO的
toString()或getter——防止Hibernate懒加载、Spring代理触发N+1查询；优先用Field.get(obj)直取字段值 - 非法字节序列（如UTF-8截断）不抛异常，而是走自定义
CharsetDecoder.onMalformedInput(CodingErrorAction.REPLACE)，在替换前先查敏感上下文
