Shopware 6.4主题上传报错：基础插件分析失败如何解决？

报错信息 #

Basic plugin analysis failed.

The information provided in the composer.json file is invalid
Context: [
 • required.shopware/core#mismatch: The compatibility in your composer.json \"required\".\"shopware/core\" was set to Version 6.4.* These versions are missing in your account to fulfill this requirement: 6.4.20.2
]

问题场景 #

为Shopware 6.4创建主题后，上传压缩包至商户后台时触发上述错误。已将主题兼容性设置为6.4.0.0 - 6.4.20.1，当前composer.json中的版本配置为：

"require": {
  "shopware/core": "6.4.*"
}

报错原因 #

Shopware 6的版本号采用四段式格式（主版本.次版本.补丁版本.修订版本，例如6.4.20.2）。你使用的6.4.*是三段式通配符，Composer解析时会将其匹配为6.4.x（第三段任意），但Shopware后台的兼容性校验逻辑会认为该范围包含了6.4.20.2这类四段版本，而你的账户没有该版本的权限，因此触发版本不匹配错误。

解决办法 #

将composer.json中shopware/core的版本要求修改为双通配符格式6.4.*.*，这样就能精确匹配你设置的6.4.0.0 - 6.4.20.1四段式版本范围，避免被解析到超出权限的版本。

修改后的配置示例：

"require": {
  "shopware/core": "6.4.*.*"
}

内容的提问来源于stack exchange，提问作者Magnus von Bromsen