日志必须完整记录异常堆栈、显式拼接业务上下文、合理区分error/warn级别、严格脱敏敏感信息。正确写法：log.error("msg", e)；禁用e.getMessage()或e.toString()；MDC需手动复制与清理；异步任务须传递上下文；敏感字段须调用脱敏工具。

异常堆栈必须完整记录，不能只打 getMessage()

很多同学在 catch 块里只写 log.error(e.getMessage())，结果线上出问题时完全看不到哪行代码抛的异常、参数是什么、调用链怎么走的。Java 的 Throwable 对象自带完整堆栈，日志框架（如 Logback、Log4j2）只要传入 Exception 实例本身，就能自动展开。

• ✅ 正确写法：log.error("用户支付失败", e)（第二个参数是 Throwable）
• ❌ 错误写法：log.error("用户支付失败: " + e.getMessage())（丢弃堆栈）
• ⚠️ 注意：e.toString() 也不行，它只包含类名+消息，没有堆栈行号

业务上下文要显式拼进日志消息，别依赖 MDC 自动注入

MDC（Mapped Diagnostic Context）看着方便，但容易漏设、错设、跨线程失效。比如异步线程没手动 MDC.copy()，或者 filter 里没清理，会导致后续请求日志混入旧 traceId。

• 显式拼接更可控：log.error("支付失败[orderNo={} userId={} amount={}]", orderNo, userId, amount, e)
• 如果用 MDC，务必在入口（如 Spring Filter）设 MDC.put("traceId", ...)，并在 finally 中 MDC.clear()
• 异步任务（如 @Async、线程池）必须手动 MDC.getCopyOfContextMap() 并在子线程还原

区分 error 和 warn：可恢复的异常用 warn，不可恢复的才 error

不是所有 catch 都该记 error 级别。比如调第三方接口超时后自动重试成功了，记 error 会污染告警指标；而空指针或数据库连接彻底断开，才是真正需要人工介入的 error。

• IOException（网络/IO 类）：多数情况应先 warn + 重试逻辑，连续失败再升 error
• IllegalArgumentException / NullPointerException：通常是代码缺陷，直接 error
• BusinessException（自定义业务异常）：按语义决定级别，例如“余额不足”是预期业务流，warn 即可

敏感信息必须脱敏，日志里不能出现明文密码、身份证、银行卡号

曾经有项目把 e.printStackTrace() 直接写进文件，结果用户手机号和 token 全量泄露。Java 异常本身不会带敏感字段，但你在日志消息里拼的变量可能带。

立即学习“Java免费学习笔记（深入）”；

• 禁止在日志中拼接原始请求体、headers、token 字符串
• 使用工具类统一脱敏：DesensitizationUtil.idCard(idCard)、DesensitizationUtil.mobile(mobile)
• 配置日志框架的 PatternLayout 时，避免用 %ex（全堆栈）而不用 %throwable —— 二者等价，重点是别在消息里自己加敏感内容

log.warn("短信发送失败[phone={} templateId={}]", DesensitizationUtil.mobile(phone), templateId, e);

# java  # app  # 工具  # 栈  # 异步任务  # java异常 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： Laravel怎么集成Vue.js_Laravel Mix配置Vue开发环境  专业企业网站设计制作公司,如何理解商贸企业的统一配送和分销网络建设？  JavaScript模板引擎Template.js使用详解  Laravel如何监控和管理失败的队列任务_Laravel失败任务处理与监控  制作电商网页,电商供应链怎么做？  Win11怎么关闭专注助手 Win11关闭免打扰模式设置【操作】  高端智能建站公司优选：品牌定制与SEO优化一站式服务  百度浏览器网页无法复制文字怎么办 百度浏览器复制修复  Laravel怎么为数据库表字段添加索引以优化查询  高端云建站费用究竟需要多少预算？  网站制作价目表怎么做,珍爱网婚介费用多少？  网站广告牌制作方法,街上的广告牌，横幅，用PS还是其他软件做的？  浏览器如何快速切换搜索引擎_在地址栏使用不同搜索引擎【搜索】  如何在腾讯云服务器上快速搭建个人网站？  Laravel如何操作JSON类型的数据库字段？（Eloquent示例）  Linux网络带宽限制_tc配置实践解析【教程】  如何快速搭建虚拟主机网站？新手必看指南  详解Nginx + Tomcat 反向代理 如何在高效的在一台服务器部署多个站点  原生JS获取元素集合的子元素宽度实例  Laravel如何连接多个数据库_Laravel多数据库连接配置与切换教程  如何在万网利用已有域名快速建站？  如何挑选最适合建站的高性能VPS主机？  如何快速搭建FTP站点实现文件共享？  Laravel怎么使用Blade模板引擎_Laravel模板继承与Component组件复用【手册】  Laravel怎么调用外部API_Laravel Http Client客户端使用  移动端手机网站制作软件,掌上时代，移动端网站的谷歌SEO该如何做？  nginx修改上传文件大小限制的方法  手机网站制作平台,手机靓号代理商怎么制作属于自己的手机靓号网站？  Laravel Eloquent性能优化技巧_Laravel N+1查询问题解决  Microsoft Edge如何解决网页加载问题 Edge浏览器加载问题修复  Laravel中间件起什么作用_Laravel Middleware请求生命周期与自定义详解  如何制作一个表白网站视频,关于勇敢表白的小标题？  如何获取免费开源的自助建站系统源码？  Laravel Admin后台管理框架推荐_Laravel快速开发后台工具  jQuery validate插件功能与用法详解  如何在七牛云存储上搭建网站并设置自定义域名？  常州企业网站制作公司,全国继续教育网怎么登录？  如何在橙子建站上传落地页？操作指南详解  如何快速生成橙子建站落地页链接？  Laravel如何实现文件上传和存储？（本地与S3配置）  nodejs redis 发布订阅机制封装实现方法及实例代码  JS实现鼠标移上去显示图片或微信二维码  IOS倒计时设置UIButton标题title的抖动问题  如何快速查询网站的真实建站时间？  Laravel的.env文件有什么用_Laravel环境变量配置与管理详解  如何快速搭建支持数据库操作的智能建站平台？  Laravel模型事件有哪些_Laravel Model Event生命周期详解  免费视频制作网站,更新又快又好的免费电影网站？  Win10如何卸载预装Edge扩展_Win10卸载Edge扩展教程【方法】  微信小程序 五星评分(包括半颗星评分)实例代码