部署Sitecore JSS React应用报templatesPath配置错误

问题场景 #

• 部署环境：Sitecore SXA部署模式，单JSS租户下包含多个独立域名，本次部署目标为租户下单个域名对应的站点
• 故障现象：本地创建React JSS应用后执行部署命令，清单上传到Sitecore后导入失败，核心报错为模板路径未配置

执行的部署命令 #

PS C:\Users\rohith\Downloads\reactapp> jss deploy:reactapp --acceptCertificate thumbprint
> npm run deploy:reactapp -- --acceptCertificate thumbprint
jss deploy app --destination C:\inetpub\wwwroot\reactappsc.dev.local\dist\reactapp "--acceptCertificate" "thumbprint"

关键日志说明 #

部署过程输出的日志中，以下提示属于正常逻辑，无需处理：

路径或匹配规则'./sitecore/pipelines//*.patch.js'未匹配到任何文件。
路径或匹配规则'./sitecore/pipelines//*.patch.ts'未匹配到任何文件。
该提示是JSS清单生成阶段扫描自定义管道补丁文件的默认逻辑，项目无自定义补丁时会触发该提示，不影响部署流程。

导致部署失败的核心报错为：
配置校验提示：VerifyAppConfiguration - Import templates path was not set for app reactapp, ensure 'templatesPath' attribute is configured.

排查解决步骤 #

• 第一步：校验Sitecore端JSS应用配置
  登录Sitecore内容编辑器，定位到当前目标域名对应的SXA站点下的JSS应用配置项，默认路径为/sitecore/content/<对应JSS租户名>/<目标域名站点名>/Settings/JSS App，找到字段列表中的templatesPath属性，该字段为必填项，SXA场景下默认值为/sitecore/templates/<对应JSS租户名>/<目标域名站点名>，如果字段为空，补全对应模板存储路径后保存配置项。
• 第二步：校验本地JSS项目配置
  打开本地React项目根目录下的scjssconfig.json文件，核对三个核心参数：
  1. appName必须和Sitecore后台创建的JSS应用名称完全一致，大小写敏感
  2. deployUrl必须指向当前目标域名的JSS导入接口，格式为https://<目标域名>/sitecore/api/jss/import，避免误请求同租户下其他站点的导入接口
  3. deploySecret必须和目标站点JSS应用配置中设置的部署密钥完全一致
• 第三步：校验SXA站点挂载关系
  多租户场景下不要将单域名的JSS应用项直接挂载在JSS租户根节点，必须放在对应SXA站点的Settings节点下，否则会因为SXA的配置作用域隔离规则，导致导入流程无法读取到站点专属的模板路径配置。
• 第四步：重新执行部署
  所有配置校验修正完成后，在本地项目根目录重新执行部署命令即可完成导入：

  jss deploy app --acceptCertificate <你的Sitecore实例证书指纹>
  

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