Ansible copy模块文件变更后notify触发handler失败问题

handler未按预期触发，核心是三个书写和逻辑问题：

• 变量名不匹配：instances.yml中定义的配置字典变量名为instances，copy任务循环时错误引用了不存在的instances1，属于基础笔误。
• 结果解析逻辑有缺陷：handler中直接用selectattr过滤循环结果时，没有先判断changed属性是否存在，当循环项存在跳过、执行失败等状态时，过滤器会直接报错中断，表现为handler完全不触发。
• 路径书写不规范：copy模块的目标路径写为etc/xxx.yaml是相对路径，会把文件下发到Ansible执行用户家目录下的etc文件夹，不是系统根路径的/etc，容易出现权限、路径不匹配的隐性问题。

方案1：最小改动修复（保留原有任务结构） #

只需要修正笔误、补全过滤器兼容逻辑即可：

1. 修正playbook.yml内容

- name: 下发实例配置文件
  copy:
    src: "roles/{{ item.value.name }}.yaml"
    dest: "/etc/{{ item.value.name }}.yaml"
  with_dict: "{{ instances }}"
  register: copy_result
  notify: my_handler

# 如果需要配置变更后立刻重启，不需要等所有任务跑完，加下面这行
- name: 立刻触发待执行的handler
  meta: flush_handlers

2. 修正handlers/main.yml内容，增加属性存在性判断避免过滤器报错，同时匹配重启需求

- name: my_handler
  # 替换为你实际需要的实例重启命令，原写法的notify命令不符合重启Docker服务的需求
  # 如果要针对单实例重启对应容器，可写为 shell: "docker restart {{ item.key }}"
  shell: "systemctl restart docker --no-block"
  loop: "{{ copy_result.results | selectattr('changed', 'defined') | selectattr('changed', 'equalto', true) | map(attribute='item') | list }}"

方案2：更稳妥的逐实例触发方案（推荐生产环境用） #

把多实例循环从单任务中拆出来，每个实例的配置下发作为独立任务，哪个实例配置变更就单独触发对应重启，不会出现结果集解析错误的问题：

1. 主playbook.yml内容

- name: 遍历所有实例下发配置
  include_tasks: deploy_instance_config.yml
  loop: "{{ instances | dict2items }}"
  loop_control:
    loop_var: current_instance

2. 新建任务文件deploy_instance_config.yml

- name: 下发{{ current_instance.key }}实例配置
  copy:
    src: "roles/{{ current_instance.value.name }}.yaml"
    dest: "/etc/{{ current_instance.value.name }}.yaml"
  notify: restart_instance_docker

3. handlers/main.yml内容

- name: restart_instance_docker
  shell: "docker restart {{ current_instance.key }}"

这种写法下每个实例的变更和handler是一一绑定的，不会出现批量循环任务的变量作用域、结果解析问题，排查问题也更简单。

• 如果你的playbook中定义了多个handlers触发点，默认handler只会在整个play的所有tasks执行完成后统一运行一次，如果需要变更后立刻执行重启动作，一定要在copy任务后加meta: flush_handlers。
• 不要在register变量中使用template这类和Ansible内置模块同名的命名，容易出现变量冲突。

内容的提问来源于stack exchange，提问作者teerrrzi