自定义Ansible模块获取inventory_hostname为空问题求助（network_cli连接）

当你使用network_cli连接类型操作网络设备时，inventory_hostname并不会自动作为模块参数被注入，所以直接从module.params里取host得到null是正常的。这里有几个靠谱的解决办法：

方法1：显式在Playbook中传递变量 #

这是最直观且可控的方式，直接在调用自定义模块时把inventory_hostname传进去：

- name: 调用我的自定义网络模块
  my_custom_network_module:
    host: "{{ inventory_hostname }}"

之后在你的模块代码里，就能通过module.params.get('host')拿到正确的主机名了。

方法2：通过Ansible Facts获取 #

inventory_hostname属于Ansible内置的facts变量，只要你在Playbook中开启了facts收集（网络设备可以用gather_subset: min来减少收集的数据量），就能从模块的ansible_facts参数里获取：

# 模块代码片段
inventory_hostname = module.params.get('ansible_facts', {}).get('inventory_hostname')

注意：如果Playbook里设置了gather_facts: no，这种方法就失效了，所以得确保facts已收集。

方法3：从network_cli连接上下文获取 #

因为你用的是network_cli连接，模块运行时已经和目标设备建立了连接，可以直接从连接上下文里提取目标主机信息，不需要依赖facts或手动传参：

# 模块代码片段
from ansible.plugins.connection.network_cli import Connection

conn = module._connection
inventory_hostname = conn._play_context.remote_addr

这种方式适合不想额外传参或收集facts的场景，但要注意不同Ansible版本的内部API可能有细微变化，建议在你使用的版本上测试验证。

小建议 #

优先推荐方法1，显式传递变量让模块的逻辑更清晰，后续维护或其他人接手代码时能一眼看懂参数来源，减少不必要的困惑。

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