Shopware 6 Valet环境安装访问报销售渠道匹配错误求助

报错核心原因 #

触发Unable to find a matching sales channel for the request报错的根本原因有三个：

• 仅执行system:setup只完成了.env环境配置文件生成，没有执行完整安装流程，数据库表结构、初始数据、默认销售渠道配置都未初始化
• Valet站点绑定路径错误，在public目录下执行link会导致站点根目录映射异常
• 初始销售渠道未绑定http://production.test域名，请求无法匹配到对应的前台门店渠道

修复步骤 #

1. 修正Valet站点绑定
   首先进入之前执行绑定的public目录，解绑错误的站点配置：

valet unlink production.test

返回项目根目录（和composer.json同级的production目录），重新执行绑定，Valet会自动识别Shopware的public目录作为Web根目录：

valet link production.test
# 如需本地HTTPS访问可执行下面这行，非必须
valet secure production.test

2. 执行完整系统安装
   在项目根目录执行全量安装命令，自动完成数据库创建、表结构导入、初始数据生成、默认管理员账号创建：

./bin/console system:install --create-database --basic-setup

执行过程中按提示填写管理员账号、密码、邮箱即可。

3. 配置销售渠道域名映射
   两种方式二选一即可：

• 命令行快速配置：
  先执行命令查看所有销售渠道列表，获取默认Storefront（前台门店）渠道的ID：

  ./bin/console sales-channel:list
  

  拿到ID后执行域名更新命令：

  ./bin/console sales-channel:update:domain --id <填入刚才查到的销售渠道ID> http://production.test
  

• 后台可视化配置：
  访问http://production.test/admin，用安装时创建的管理员账号登录，进入对应前台销售渠道的配置页，在域名板块添加http://production.test为访问域名，保存即可。

4. 清理缓存生效
   执行缓存清理命令，让所有配置生效：

./bin/console cache:clear

提示：因为配置时开启了Blue Green Deployment，建议额外执行./bin/console theme:refresh刷新主题静态资源，避免前台样式、脚本加载异常。

完成以上步骤后直接访问http://production.test即可正常进入Shopware前台页面，不会再触发该报错。

内容的提问来源于stack exchange，提问作者Marc Abdel Wahed