Ansible通过notify触发handlers实现配置变更后自动重启，仅当task标记changed时才执行，确保幂等性；notify与handler名称必须完全一致，且推荐使用service模块而非command。

Ansible 的 Handlers 机制正是为解决“只在真正变更时才重启服务”而设计的。它的核心逻辑不是靠人工判断，而是依赖 Ansible 对任务执行结果的自动标记（changed 状态）。只要配置文件内容发生物理变化（哪怕只是多一个空格），Ansible 就会触发 handler；反之，若源与目标完全一致，就跳过通知、不重启。

关键前提：让 Ansible 能准确感知“物理变更”

Handler 是否执行，完全取决于 notify 所在 task 是否被标记为 changed。而这个标记由模块自身决定：

• template 和 copy 模块默认通过比对渲染后内容（或文件二进制）来判断是否 changed —— 这就是物理层面的校验
• 如果用了 lineinfile 或 replace，它们只在实际插入、替换或删除行时才标记 changed；没匹配到目标行，就不会变
• 避免用 command 或 shell 去写配置文件 —— 它们无法感知内容是否真变了，总是标记 changed 或 ok，失去判断依据

标准写法：notify + handlers 配对必须严格一致

handler 不是“看到 notify 就跑”，它要求名称字符串完全匹配（含空格、大小写、标点）：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• task 中写 notify: restart nginx，handlers 里就必须是 - name: restart nginx
• 拼错一个字母、多一个空格，handler 就静默失效 —— 这是最常见的失败原因
• 一个 task 可以 notify 多个 handler，比如同时通知 restart nginx 和 reload logrotate

推荐使用的 service 管理方式

重启操作应统一使用 service 或 systemd 模块，而不是 shell 命令：

• ✅ 正确：service: name=nginx state=restarted —— 支持幂等性、状态检查、错误捕获
• ❌ 错误：command: systemctl restart nginx —— Ansible 无法确认是否成功，且每次执行都算 changed
• ⚠️ 注意：state: restarted 是完整重启；state: reloaded 是热重载，行为因服务而异，不要混用

验证是否真触发了重启

执行 playbook 后，直接看输出中的状态标识：

• 如果看到 changed: [host] 出现在配置任务行，且后续有 RUNNING HANDLER [restart nginx]，说明物理变更被识别并触发了重启
• 如果配置任务显示 ok: [host]，那 handler 一定不会运行 —— 这是预期行为，不是 bug
• 可加 -v 参数查看详细差异，例如 template 渲染前后内容对比