Ansible模板php.ini报错：dict object has no element [] 求助

错误原因 #

报错dict object has no element []的核心原因是**php_config_options变量未被Ansible正确加载**，导致模板中尝试访问不存在的字典元素。默认情况下，Ansible不会自动加载vars/目录下的文件，除非通过角色结构的defaults/vars目录，或显式调用include_vars加载。

另外，原逻辑无法实现「默认值+自定义单变量覆盖」的需求——如果直接在group_vars/host_vars中定义php_config_options，会直接覆盖整个默认字典，而非合并单个字段。

分步解决方案 #

1. 规范默认变量存放与加载 #

将默认配置移至角色的defaults/main.yaml（优先级最低，确保能被自定义变量覆盖），或通过显式任务加载vars/Ubuntu-22.yaml：

方式一：使用角色默认值（推荐）

# roles/php/defaults/main.yaml
php_config_defaults:
  cli:
    engine: "On"
    short_open_tag: "Off"
    precision: 14
    # ...其他默认配置项
  apache2:
    engine: "On"
    short_open_tag: "Off"
    precision: 14
    # ...其他默认配置项

方式二：显式加载vars文件

在playbook中添加加载任务：

- name: 加载PHP默认配置
  ansible.builtin.include_vars:
    file: vars/Ubuntu-22.yaml

2. 实现默认值与自定义值合并 #

在group_vars/host_vars中定义需要覆盖的单个配置项（无需重复所有默认值）：

# group_vars/webservers.yaml 或 host_vars/your_host.yaml
php_config_custom:
  apache2:
    short_open_tag: "On"  # 仅覆盖需要修改的项
    memory_limit: "256M"

3. 修改Ansible任务与模板 #

调整任务逻辑，合并配置

使用combine过滤器将默认配置与自定义配置合并，确保只覆盖指定字段：

- name: setup | Template php.ini
  ansible.builtin.template:
    src: "{{ php_version }}/php.ini.j2"
    dest: /etc/php/{{ php_version }}/{{ environment }}/php.ini
    owner: root
    group: root
    mode: 0644
  vars:
    environment: "apache2"
    # 合并默认配置与自定义配置，不存在自定义项时用空字典兜底
    php_config_combined: "{{ php_config_defaults[environment] | combine(php_config_custom[environment] | default({})) }}"

更新模板，使用合并后的配置

简化模板逻辑，直接遍历合并后的配置字典：

{% for option, value in php_config_combined.items() %}
{{ option }} = {{ value }}
{% endfor %}

额外说明 #

• 变量优先级：Ansible遵循host_vars > group_vars > role defaults的优先级，因此自定义配置会优先覆盖默认值。
• 多环境适配：如需同时生成apache2和cli的php.ini，可通过循环任务实现：

- name: setup | Template php.ini for all environments
  ansible.builtin.template:
    src: "{{ php_version }}/php.ini.j2"
    dest: /etc/php/{{ php_version }}/{{ item }}/php.ini
    owner: root
    group: root
    mode: 0644
  loop: ["apache2", "cli"]
  vars:
    environment: "{{ item }}"
    php_config_combined: "{{ php_config_defaults[item] | combine(php_config_custom[item] | default({})) }}"

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