生产环境禁止e.printStackTrace()，须用SLF4J记录带业务标识的日志；禁用空catch；受检异常仅用于调用方必须恢复的场景；finally中避免抛异常，优先用try-with-resources；异常信息需含可行动上下文并脱敏敏感数据。
避免在 catch 块里只写 e.printStackTrace()
这是最常见也最危险的习惯——它把异常信息输出到标准错误流，既没记录上下文，也没触发监控，线上出问题时根本没法定位。生产环境必须用日志框架（如 SLF4J）记录，并带上关键业务标识。
- 用
logger.error("订单支付失败，orderNo={}", orderNo, e)，而非e.printStackTrace() - 不要吞掉异常：空
catch块或只打日志不抛出/不处理，等于掩盖故障 - 若决定忽略某类异常（如
InterruptedException在清理线程时），必须加明确注释说明“为什么可忽略”
区分 RuntimeException 和受检异常的使用场景
Java 强制你处理受检异常（Exception 及其子类，但不包括 RuntimeException），但这不意味着“所有异常都该是受检的”。滥用受检异常会导致大量无意义的 throws 声明和模板式 try-catch，反而降低可读性。
- 受检异常适合：调用方**必须决策如何恢复**的场景，比如
IOException（文件不存在？重试？降级？） -
RuntimeException更适合：程序逻辑错误或不可恢复的意外，如IllegalArgumentException、NullPointerException（应提前校验，而非靠 catch） - 自定义异常优先继承
RuntimeException，除非你有强契约要求调用方显式处理
不要在 finally 里执行可能抛异常的操作
finally 的本意是保证资源释放，但如果里面又抛出新异常，会覆盖原始异常，导致根因丢失——这是调试时最让人抓狂的问题之一。
dcc-cli-gateway
下载
通过 `dcc-mcp-cli` 命令行工具控制实时 DCC 主机（Maya、Blender、Houdini、Photoshop、3ds Max 以及自定义的 Studio 工具）。 针对 ClawHub、OpenClaw、Cursor、Claude 和支持 shell 的 Agent 主机：验证网关健康状态、列出已注册的 DCC 实例、搜索工具、检查 Schema、调用工具——全程无需直接编写或发送 MCP 请求。 若系统中未安装 `dcc-mcp-cli`，需先征得用户同意，再从 GitHub
- 关闭资源用
try-with-resources，它自动抑制（suppressed）后续异常，保留主异常 - 如果必须手写
finally（如老 JDK），对每个 close 操作单独 try-catch，并记录而非抛出 - 示例错误写法：
finally { outputStream.close(); }——close()可能抛IOException，覆盖前面的业务异常
异常信息要包含“可行动”的上下文，而非仅堆栈
堆栈告诉你“哪里出错了”，但运维和下游服务需要知道“什么条件下错的”。比如 "HTTP 500 from payment gateway" 远不如 "Payment gateway timeout after 30s, requestID=abc123, amount=¥299.00" 有用。
立即学习“Java免费学习笔记（深入）”；
- 构造异常时传入组合字符串，而非拼接后丢给
getMessage() - 避免泛化消息如
"操作失败"，换成"无法更新用户邮箱：邮箱已被其他账号占用（email=john@example.com）" - 敏感信息（密码、token、身份证号）必须脱敏，日志中禁止明文出现
