核心交易链路日志应采用分层+切面+配置驱动方式：用Spring AOP统一拦截、脱敏裁剪敏感字段、按环境动态开关，并通过异步限流保障性能。
在核心交易链路中打印入参和出参，关键不是“能不能打”，而是“怎么打才安全、可控、可维护”。直接在业务方法里写 log.info("入参: " + request) 看似简单，但容易引发性能问题、敏感信息泄露、日志爆炸或格式混乱。推荐采用分层+切面+配置驱动的方式，兼顾可观测性与生产稳定性。
用 Spring AOP 统一拦截核心方法
避免在每个 service 方法里硬编码日志，而是通过切点精准捕获交易入口（如 @Transactional 方法、特定包路径下的 *Service.process* 方法）：
- 定义切面类，使用
@Around拦截目标方法执行前后 - 方法执行前获取参数（建议用
JoinPoint.getArgs()并做浅拷贝或脱敏处理） - 方法执行后捕获返回值（注意判空和异常情况，
proceed()抛异常时需在catch中记录失败日志） - 日志内容结构化：包含 traceId、方法名、耗时、入参摘要、出参摘要（非全量）、结果状态
入参/出参必须做脱敏和裁剪
交易链路常含身份证、手机号、银行卡号、金额明细等敏感字段，直接打印等于埋雷：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 不打印原始对象 toString()，改用自定义序列化器（如 Jackson 的
SimpleModule注册脱敏序列化器） - 对常见敏感字段（如
idCard,phone,cardNo）自动掩码：如138****1234、6228**********1234 - 限制日志长度：单个参数字段超过 200 字符则截断并标记
[TRUNCATED]，防止刷屏或磁盘打满 - 复杂嵌套对象只打印 2 层深度，列表类字段默认只打前 3 条
按环境和级别动态开关日志
不是所有环境都需要全量出入参日志：
立即学习“Java免费学习笔记（深入）”；
- 开发/测试环境：默认开启，日志级别设为
DEBUG或独立 marker（如MARKER_TRADE_TRACE） - 预发/生产环境：默认关闭；通过 Apollo/Nacos 配置中心实时控制开关，支持按接口粒度开启（如
trade.pay.process） - 日志框架（Logback/Log4j2）配置异步 Appender + 大小限流（如每秒最多 100 条交易链路日志），避免拖慢主流程
补充：替代方案与兜底建议
若无法引入 AOP（如老系统或非 Spring 环境），可考虑更轻量方式：
- 在交易网关或统一 Facade 层做日志拦截（如 Dubbo Filter、Spring Cloud Gateway GlobalFilter）
- 用注解 + 编译期插桩（如 lombok 的
@Log不适用，但可自定义@TraceLog+ Annotation Processor 生成日志代码） - 关键节点加“快照日志”：只在异常分支或超时分支补打完整入参/上下文（用
log.warn("timeout, full request: {}", request)） - 永远保留 traceId，并确保上下游（MQ、HTTP 调用）透传，方便日志关联排查
