重写 toString 方法应只包含关键字段、格式统一且 null 安全、无副作用、排除敏感信息；例如 User{id=101, username='admin', active=true}，禁用密码等敏感字段输出。
实体类重写 toString 方法，核心是让输出既清晰反映业务状态，又稳定安全、便于维护。
只包含关键字段，不堆砌全部属性
实体类常有十几甚至几十个字段，但调试和日志中真正需要“一眼看清”的往往只有几个身份标识或核心状态字段。比如：
-
User 类：通常关注
id、username、status，而非createTime、lastLoginIp等次要信息 -
Order 类：重点是
orderNo、amount、state，无需展开每个商品明细
字段过多不仅降低可读性，还可能引入空指针或性能隐患。
格式统一、结构清晰、兼顾 null 安全
推荐使用括号包裹 + 键值对 + 逗号分隔的格式，例如：User{id=101, username='admin', active=true}。这样利于人眼扫描，也方便日志系统做简单解析。
立即学习“Java免费学习笔记（深入）”；
对可能为 null 的引用类型字段（如 String email），必须判空处理：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 用
Objects.toString(email, "null")（推荐，简洁且线程安全） - 或手动判断：
email != null ? "'" + email + "'" : "null"
避免直接拼接导致 NullPointerException。
禁止副作用，不调用耗时或修改状态的操作
toString() 是纯观察行为，不能：
- 触发数据库查询、远程调用、文件读取等 I/O 操作
- 调用可能改变对象内部状态的 getter（如带缓存计算或懒加载逻辑的 getter）
- 抛出受检异常（方法签名不允许）或运行时异常（破坏调用方预期）
如果字段本身需计算，建议提前在构造或 setter 中完成，toString 只读取已确定的值。
敏感字段必须排除，尤其密码、密钥、身份证号等
日志和调试器会自动调用 toString()，若未过滤，极易造成敏感信息泄露。
- 手写时直接跳过该字段，不参与拼接
- 使用 Lombok 时加
@ToString(exclude = {"password", "idCard"}) - 即使字段名含 “password” 或 “token”，也不应出现在输出中
这不是可选项，而是安全红线。
