Ansible配置JDK环境变量后，Kafka脚本无法找到Java可执行文件

场景 #

通过Ansible从tar.gz包部署JDK，不依赖RedHat仓库。已通过lineinfile配置/etc/profile和用户~/.bashrc的环境变量：

- name: Set JDK environment variables
  become: yes
  lineinfile: 
    path: /etc/profile
    state: present
    line:"{{item}}"
  with_items:
    - 'export JAVA_HOME="{{java_dir}}"'
    - 'export PATH=$PATH;$JAVA_HOME/bin:$PATH'

- name: Set JDK environment for next tasks
  become: yes
  lineinfile: 
    path: /home/user/.bashrc
    state: present
    line:"{{item}}"
  with_items:
    - 'export JAVA_HOME="{{java_dir}}"'
    - 'export PATH=$PATH;$JAVA_HOME/bin:$PATH'

登录目标机器执行java --version正常，但Ansible执行依赖JVM的任务（如./kafka-storage.sh random-uuid）时，报错：

/opt/kafka/bin/kafka-run-class.sh line 346: exec : java: not found

原因 #

1. Shell环境差异：Ansible的shell/command模块默认使用非交互式、非登录Shell，不会自动加载/etc/profile或~/.bashrc这类配置文件，因此之前配置的环境变量在Ansible任务执行时未生效。
2. PATH配置错误：Linux系统的路径分隔符是冒号:，而非分号;，原配置中PATH=$PATH;$JAVA_HOME/bin:$PATH的写法错误，会导致路径解析失败。

解决方案 #

方案1：给Ansible任务直接传递环境变量 #

在执行依赖JVM的任务时，通过environment参数直接指定环境变量：

- name: Generate Kafka UUID
  shell: ./kafka-storage.sh random-uuid
  args:
    chdir: /opt/kafka/bin
  environment:
    JAVA_HOME: "{{ java_dir }}"
    PATH: "{{ ansible_env.PATH }}:{{ java_dir }}/bin"

方案2：执行命令时显式加载环境配置 #

在执行脚本前，先加载/etc/profile，同时指定bash登录模式确保配置生效：

- name: Generate Kafka UUID
  shell: source /etc/profile && ./kafka-storage.sh random-uuid
  args:
    chdir: /opt/kafka/bin
    executable: /bin/bash -l

方案3：规范配置环境变量（推荐） #

在/etc/profile.d/目录下创建专属的JDK环境变量脚本，这是Linux系统配置全局环境变量的标准方式，非登录Shell默认会加载该目录下的脚本：

- name: Create JDK environment script
  become: yes
  copy:
    dest: /etc/profile.d/jdk.sh
    content: |
      export JAVA_HOME="{{ java_dir }}"
      export PATH=$PATH:{{ java_dir }}/bin
    mode: '0644'

配置完成后，后续Ansible任务无需额外操作，重新连接目标机器或临时执行source /etc/profile.d/jdk.sh即可生效。

方案4：修复原PATH配置的语法错误 #

将原配置中的分号;改为冒号:：

- name: Set JDK environment variables
  become: yes
  lineinfile: 
    path: /etc/profile
    state: present
    line:"{{item}}"
  with_items:
    - 'export JAVA_HOME="{{java_dir}}"'
    - 'export PATH=$PATH:{{ java_dir }}/bin:$PATH'

此方案需配合方案2使用，才能解决Ansible Shell不加载配置文件的问题。

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