通过PuTTY SSH安装Magento 2.3.0时执行Composer命令报依赖错误

故障本质 #

Magento 官方仓库（repo.magento.com）默认优先级高于公共 Packagist 仓库，满足版本约束要求的 magento/composer ~1.4.0 包被高优先级仓库的版本列表拦截，无法被正常识别安装。

落地操作步骤 #

• 清理本地Composer缓存，消除旧缓存对依赖解析的干扰
  执行命令：composer clearcache
• 替换原项目创建命令，显式指定Composer优先匹配Packagist公共仓库的依赖版本：

  composer create-project --repository-url=https://repo.magento.com/ --prefer-packagist magento/project-community-edition=2.3.0 .
  

  该参数会强制Composer优先校验Packagist源中的匹配版本，绕开Magento仓库的高优先级拦截逻辑
• 若上述命令执行后仍报版本不匹配错误，手动调整仓库优先级配置：
  1. 在站点空目标目录下执行初始化命令生成基础配置文件：composer init --no-interaction
  2. 打开生成的composer.json，在配置块中添加如下规则，关闭Magento仓库的独占优先级校验：

     "repositories": {
         "magento": {
             "type": "composer",
             "url": "https://repo.magento.com/",
             "canonical": false
         }
     }
     

  3. 配置完成后执行依赖安装命令：composer require magento/product-community-edition=2.3.0 --no-update && composer update
• 若仍存在版本识别障碍，可手动在全局Composer环境中锁定适配的magento/composer版本后，再执行项目创建流程：

  composer global require magento/composer=1.4.0 --no-update
  

补充校验要点 #

• 执行所有SSH命令时，需确认当前登录用户对站点目录拥有完整读写权限，避免权限异常导致安装中断
• 若使用的Composer版本低于2.0.7，建议先升级到稳定版本，旧版Composer的仓库优先级判定逻辑与Magento 2.3的依赖规则存在兼容性偏差

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