Ansible中使用inventory_hostname引用字典键值报错排查

问题场景 #

你有包含主机名、UID、GID的CSV文件，需要在Playbook中为每个目标主机提取对应UID。当前做法是先在localhost读取CSV生成键为主机名的字典并注册变量，再在目标主机上用inventory_hostname动态引用字典值时触发模板错误，但硬编码具体键名（如dag）可正常获取结果。

问题原因 #

Ansible模板语法中，当使用变量作为字典键时，不能直接用.的链式访问语法，.仅适用于固定已知的键名。用变量作为键时必须使用方括号[]语法来解析变量的实际值。

解决步骤 #

1. 示例CSV文件（hosts_uid.csv） #

name,uid,gid
web01,1001,1001
db01,1002,1002
dag,1003,1003

2. 修正后的Playbook #

- name: 在本地解析CSV生成字典
  hosts: localhost
  gather_facts: false
  tasks:
    - name: 读取CSV并以name为键生成字典
      read_csv:
        path: hosts_uid.csv
        key: name
      register: host_uid_dict

- name: 为目标主机动态获取对应UID
  hosts: all
  gather_facts: false
  tasks:
    - name: 输出当前主机的UID
      debug:
        msg: "当前主机{{ inventory_hostname }}的UID是{{ host_uid_dict.dicts[inventory_hostname]['uid'] }}"

关键修正点 #

将原错误的引用方式host_uid_dict.dicts.inventory_hostname.uid改为host_uid_dict.dicts[inventory_hostname]['uid']（或host_uid_dict.dicts[inventory_hostname].uid，核心是用[]包裹变量键）。

额外防护措施 #

为避免因主机名与CSV中name字段不匹配导致的错误，可添加存在性检查：

- name: 检查主机是否在CSV中有对应记录
  debug:
    msg: "警告：主机{{ inventory_hostname }}未在CSV中找到UID记录"
  when: inventory_hostname not in host_uid_dict.dicts

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