HDFS 进入安全模式（SafeMode）的场景

一、被动触发（HDFS 自动进入）‌

1. ‌NameNode 启动阶段‌

   • ‌元数据加载‌：NameNode 启动时需加载元数据（镜像文件 fsimage 和编辑日志 edits），此时自动进入安全模式，直到元数据加载完成并完成完整性校验‌。
   • ‌DataNode 注册‌：DataNode 启动后向 NameNode 注册并上报数据块状态。NameNode 需等待足够数量的 DataNode 完成注册（满足 dfs.namenode.safemode.min.datanodes 配置）才会退出安全模式‌。

2. ‌数据块副本不足‌

   • ‌副本比例阈值‌：当系统中有效副本数不足的 Block 占比超过阈值（由 dfs.namenode.safemode.threshold-pct 配置，默认 0.999，即允许丢失最多 1 个 Block）时，HDFS 自动进入安全模式‌。
   • ‌DataNode 宕机‌：大量 DataNode 故障导致可用数据节点数低于配置的 dfs.namenode.safemode.min.datanodes（默认 0），可能触发安全模式‌。

3. ‌数据完整性检查‌

   • 在冷启动或异常恢复过程中，NameNode 主动检查数据块完整性，若检测到大量 Block 损坏或丢失，将进入安全模式以阻止数据变更‌。‌

二、主动触发（管理员操作）‌

1. ‌运维操作‌

   • 管理员通过命令 hdfs dfsadmin -safemode enter 主动进入安全模式，以便进行集群维护、升级或数据迁移等操作‌。

2. ‌强制修复‌

   • 当检测到元数据不一致或数据块异常时，管理员可能手动触发安全模式，阻止写入操作并修复问题‌。‌

安全模式的特征‌

• ‌只读限制‌：安全模式下，HDFS 仅接受读请求，拒绝删除、修改、副本复制等写操作‌。
• ‌自动退出条件‌：需同时满足以下条件并持续稳定时间（dfs.namenode.safemode.extension，默认 30 秒）后自动退出：
  • 有效副本数不足的 Block 占比低于阈值‌。
  • 可用 DataNode 数量达到配置要求‌。

总结

‌场景分类‌	‌触发原因‌	‌相关配置/操作‌
‌被动触发‌	NameNode 启动、DataNode 注册、副本不足、DataNode 宕机等	dfs.namenode.safemode.threshold-pct、dfs.namenode.safemode.min.datanodes‌
‌主动触发‌	管理员手动执行命令进行维护或修复	hdfs dfsadmin -safemode enter‌

‌注‌：安全模式是 HDFS 的自我保护机制，核心目的是确保数据一致性和完整性‌。