ansible角色循环依赖会在解析阶段报错，需检查meta/main.yml中的dependencies声明链，用--list-dependencies验证依赖树，通过二分排除法定位闭环，并从设计上保持角色职责单一、提取共用逻辑为独立角色。
Ansible 角色依赖出现循环引用时，Playbook 通常会在执行前就报错，提示类似 Role 'A' depends on role 'B', which depends on role 'A' 的信息。这类错误不会等到运行时才暴露，而是在解析角色依赖图阶段就被检测并中止。排查核心是理清 meta/main.yml 中的 dependencies 声明链，并验证实际加载顺序。
检查 roles 目录下的 meta/main.yml 依赖声明
每个角色若声明了依赖，必须在 roles/<role_name>/meta/main.yml</role_name> 中通过 dependencies 列表定义。逐个打开你用到的角色目录，重点查看：
- 是否存在 A → B → A 这样的闭环（例如 role_a 依赖 role_b，role_b 又依赖 role_a）
- 是否误将本角色自身写入依赖列表（如
- { role: myrole }） - 是否用了变量或条件判断导致依赖路径在不同环境下动态变化（Ansible 不支持条件化依赖）
使用 ansible-playbook --list-dependencies 验证依赖图
该命令会输出 Playbook 解析出的完整角色依赖树，不执行任何任务，专用于静态分析：
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 运行
ansible-playbook site.yml --list-dependencies - 观察输出中是否出现重复嵌套、来回跳转（如
role_a → role_b → role_c → role_a） - 注意：该命令要求所有角色路径可访问，且
meta/main.yml格式合法；若报 YAML 解析错误，先修复语法再查依赖
临时禁用部分依赖做隔离测试
当依赖链较长（如 A→B→C→D→E）难以肉眼定位时，可采用“二分排除法”：
- 注释掉某个角色的
dependencies中的部分条目，重新运行--list-dependencies - 若闭环消失，说明被注释项参与了循环；逐步恢复缩小范围
- 也可在
roles/下临时重命名可疑角色目录（如role_b_old），看错误是否消失
避免常见设计陷阱
循环引用本质是架构设计问题，不是配置错误。应从源头规避：
- 角色职责保持单一：一个角色只做一件事（如
nginx_setup或nginx_vhost），不要混入配置生成与服务管理逻辑 - 共用逻辑抽成独立角色或
include_role：若 A 和 B 都需要证书处理，应提取为cert_manager角色，而非互相引用 - 慎用
include_role替代dependencies：后者是硬依赖、启动时加载；前者是运行时调用，不参与依赖图构建，适合条件化复用
