安装Shopware 6.4.16.1时遇HOME/COMPOSER_HOME环境变量错误求助

核心排查方向及解决步骤 #

• 环境变量未在当前会话生效
  配置完HOME和COMPOSER_HOME后，若未重启Shell或重新加载配置文件，当前执行Composer的会话可能没读取到变量值。先执行echo $HOME和echo $COMPOSER_HOME验证输出：

  • 若输出为空或不符，执行source ~/.bashrc（bash环境）或source ~/.zshrc（zsh环境）重新加载配置
  • 或者退出当前SSH连接后重新登录

• 用户权限/执行环境不一致
  若用sudo执行安装，默认会重置环境变量，需用sudo -E保留当前用户环境：

  sudo -E composer create-project shopware/production my-shopware-project 6.4.16.1
  

  同时确认执行Composer的用户对COMPOSER_HOME目录有读写权限，权限异常时执行：

  chown -R 你的用户名:用户组 /path/to/composer-home
  

• Composer缓存或配置异常
  清除Composer缓存强制重新读取配置：

  composer clear-cache
  

  也可手动指定COMPOSER_HOME执行安装，绕开系统环境变量问题：

  COMPOSER_HOME=/你的/composer-home路径 composer create-project shopware/production my-shopware-project 6.4.16.1
  

• Shopware安装脚本的环境隔离问题
  先单独执行composer -V测试，若该命令正常，说明问题出在Shopware安装脚本的子Shell环境。可跳过一键安装脚本，手动用Composer创建项目后再完成后续配置。

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