SAPUI5 应用中，使用 sap.f.routing.Router 配合 FlexibleColumnLayout 时，页面刷新或直接访问深层路由 URL 会导致 onMatched 回调未执行——根本原因在于 manifest.json 中路由配置项的键名错误，需将 viewPath/viewType 替换为标准的 path/type。
如何解决 sapui5 中页面刷新时路由 onmatched 回调不触发的问题？sapui5 应用中，使用 `sap.f.routing.router` 配合 `flexiblecolumnlayout` 时，页面刷新或直接访问深层路由 url 会导致 `onmatched` 回调未执行——根本原因在于 `manifest.json` 中路由配置项的键名错误，需将 `viewpath`/`viewtype` 替换为标准的 `path`/`type`。
在基于 sap.f.FlexibleColumnLayout 的多层导航应用中（如 List → Detail → DetailDetail 三级布局），开发者常通过 attachMatched 监听路由匹配事件以初始化视图并解析 URL 参数。然而，一个典型陷阱是：路由在程序内导航时工作正常，但浏览器刷新或直接粘贴完整 URL 时，onMatched 完全静默——此时 onInit() 仍会执行，说明控制器已实例化，但路由未完成匹配流程。
该问题的根源并非代码逻辑或事件绑定方式，而是 manifest.json 中 routing.config 的配置项与 sap.f.routing.Router 的预期不兼容。sap.f.Router 是 sap.ui.core.routing.Router 的扩展，专为 FlexibleColumnLayout 设计，其内部依赖标准的路由元数据结构。若错误地沿用 sap.m.App 或传统 UIComponent 的配置习惯（如使用 "viewPath" 和 "viewType"），路由器将无法正确解析目标视图路径，导致匹配失败，进而跳过 onMatched 触发。
✅ 正确配置（适配 sap.f.routing.Router）：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
"routing": {
"config": {
"routerClass": "sap.f.routing.Router",
"type": "View", // ✅ 必须为 "View"（而非 "XML"）
"path": "com.demo.admin.view", // ✅ 使用 "path" 替代 "viewPath"
"controlId": "flexibleColumnLayout",
"async": true,
"transition": "slide"
},
"routes": [
{
"pattern": "detail/{objectId}/detailDetail/{treeObjectId}/{layout}",
"name": "detailDetail",
"target": ["list", "detail", "detailDetail"],
"greedy": true
}
],
"targets": {
"list": { "viewName": "List", "viewLevel": 1 },
"detail": { "viewName": "Detail", "viewLevel": 2 },
"detailDetail": { "viewName": "DetailDetail", "viewLevel": 3 }
}
}
⚠️ 注意事项：
- "type": "View" 是硬性要求，不可写为 "viewType": "XML" —— 后者属于旧版 sap.ui.core.routing.Router 的遗留字段，在 sap.f.Router 中被忽略；
- "path" 指向视图所在包路径（如 com.demo.admin.view），等效于 viewPath，但仅此字段被识别；
- 确保 FlexibleColumnLayout 的 id（如 "flexibleColumnLayout"）与 controlId 完全一致，且该控件在根视图（如 App.view.xml）中已声明；
- 路由目标（targets）必须定义 viewLevel，否则 sap.f.Router 无法确定列渲染顺序。
此外，建议在 onInit 中增加路由初始化状态检查：
onInit: function() {
this.oRouter = this.getOwnerComponent().getRouter();
// ✅ 确保 router 已初始化且历史状态可用
if (this.oRouter && this.oRouter.getHash()) {
console.log("Current hash:", this.oRouter.getHash());
}
this.oRouter.getRoute("detailDetail").attachMatched(this._onUrlMatched, this);
// 其他路由同理...
},
_onUrlMatched: function(oEvent) {
const oParams = oEvent.getParameter("arguments");
console.log("Matched with params:", oParams); // 自动解析 {objectId}, {treeObjectId}, {layout}
// ✅ 此处可安全调用 this.byId(...)、模型绑定或服务请求
}
总结：sap.f.routing.Router 对 manifest 配置高度敏感。页面刷新失效的本质是配置键名不匹配导致路由初始化失败。修正 viewPath → path、viewType → type 并确保值语义正确，即可恢复完整的路由生命周期行为——包括首次加载、刷新、深度链接等所有场景下的 onMatched 触发。
