Magnolia CMS 6.2.23整合React SPA报错：无模板脚本定义

1. 核对Prototype配置细节 #

• 确认prototype.yaml里的templateScript是否准确指向你的React SPA入口文件（比如/your-spa/index.html），路径要和SPA实际部署位置匹配，不能错写。
• 检查原型的renderType是否设为external-spa，别用默认的freemarker。
• 确保你的自定义原型优先级高于默认的travel演示原型——比如把自定义原型放在自己的模块里，且模块加载顺序在travel-demo之前。

2. 页面与站点配置校验 #

• 确认你创建的页面绑定的是自定义外部SPA原型，不是默认的travel页面模板。
• 打开Magnolia后台的Site app，检查站点的默认页、首页是否设为你的自定义页面，别留着travel相关的配置。
• 核对站点的URI映射规则，保证请求不会被路由到travel演示站点的路径上。

3. SPA资源部署与权限检查 #

• 确认React SPA的静态资源已经部署到Magnolia能访问到的位置，比如Tomcat的webapps目录下，或者通过Magnolia资源模块上传，路径要和templateScript里写的一致。
• 检查Tomcat和Magnolia的权限设置，确保Magnolia能读取到SPA的入口文件，别因为权限问题导致找不到模板脚本。

4. 模块加载与冲突排查 #

• 要么禁用travel-demo模块，要么确保你的自定义模块加载顺序在travel-demo之前——在模块的module.yaml里调整依赖和加载顺序。
• 看Magnolia启动日志，确认自定义模块是否成功加载，有没有初始化失败的报错。

5. 重定向规则排查 #

• 打开Magnolia的Redirects app，看看有没有把请求重定向到travel.html的规则，有的话删掉或者修改。
• 检查Tomcat的web.xml、server.xml里的路由配置，有没有额外的重定向规则干扰请求。

6. 深挖日志细节 #

• 查看RenderException的完整堆栈信息，定位是哪个模板或页面触发的错误，找到对应的配置节点。
• 开启Magnolia的debug级日志，看模板解析过程的详细输出，确认系统有没有正确找到你的外部SPA模板脚本。

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