如何在Drupal 9上安装Google Analytics并解决Composer依赖报错问题

问题根因 #

• 当前使用的是drupal/drupal核心开发专用模板，而非Drupal官方推荐的生产建站模板，该模板的composer.json配置了本地路径类型的core仓库，优先级高于Drupal官方包仓库
• 本地路径下的drupal/core被Composer识别为dev-main版本，不在Google Analytics模块要求的^8.8.6|^9.0版本约束范围内，即使实际运行的是Drupal9，也会因版本校验不通过触发报错

解决方案 #

方案1：临时快速解决（仅适合测试环境使用） #

直接在安装命令中添加-W参数放开依赖限制，执行以下命令即可：

php8.0 /usr/local/bin/composer require drupal/google_analytics ^3.1 -W

如果仍报错，可手动修改composer.json的repositories段，给本地core仓库强制指定版本号：

"repositories": [
    {
        "type": "path",
        "url": "core",
        "options": {
            "versions": {
                "drupal/core": "9.0.0"
            }
        }
    },
    // 其余仓库配置保持不变
]

修改后再执行安装命令即可，模块安装完成后可按需还原配置。

方案2：长期规范解决（适合生产环境使用） #

你当前使用的drupal/drupal模板仅用于Drupal核心开发，不适合生产建站，建议切换为官方推荐的drupal/recommended-project模板，步骤如下：

1. 备份当前站点的全部代码、数据库、sites目录下的站点配置、自定义模块/主题文件
2. 执行命令新建规范的Drupal项目：

composer create-project drupal/recommended-project your_site_dir

3. 将备份的自定义模块、主题、站点配置迁移到新项目对应的目录下
4. 后续安装所有第三方扩展都可直接用composer require drupal/xxx命令执行，不会再出现仓库优先级相关的依赖报错

内容的提问来源于stack exchange，提问作者Darius.V