cloud-web-corejs 1.0.54-dev.757 → 1.0.54-dev.759

package/src/index.js

@@ -269,6 +269,8 @@ export async function mount(props = {}) {
     menus: Array.isArray(props.menus) ? props.menus : null,
     mainAdapter: props.mainAdapter || null,
     lang: props.lang || "",
+    // 主应用经本地调试覆盖装载：允许 URL 直达未配菜单的页面
+    debug: !!props.microDebug,
   });
   // 再次挂载时 unmount 已重置路由，而 roles 仍在会使守卫跳过路由生成，这里主动补一次
   if (store.getters.roles && store.getters.roles.length > 0) {

package/src/microRouter/index.js

@@ -73,18 +73,47 @@ export function getAppRegistry() {
   );
 }
 
+const DEBUG_URL_PARAMS = ["microDebug", "microDebugAppCode", "microDebugEntry"];
+
+/** 取 URL 上某个查询参数（hash 前后都找），非法转义按原文处理 */
+function readUrlParam(href, name) {
+  const matched = href.match(new RegExp("[?&]" + name + "=([^&#]*)"));
+  if (!matched) return null;
+  const raw = matched[1] || "";
+  let value = raw;
+  try {
+    value = decodeURIComponent(raw);
+  } catch (e) {
+    // 非法转义（如值里有裸 %）会抛 URIError，按原文处理，不能让它中断注册表加载
+    value = raw;
+  }
+  return value.trim();
+}
+
 /**
  * 从 URL 读调试开关并落盘 localStorage，读到后即从地址栏抹掉（避免被收藏/分享扩散）。
  * 支持 hash 前后两种位置：?microDebug=xx#/... 与 #/...?microDebug=xx。
- * 取值同 localStorage 四档写法；microDebug=off 清除调试态。
+ * 两种写法：
+ *   ?microDebug=xx                                取值同 localStorage 四档写法；off/0 清除
+ *   ?microDebugAppCode=mkweb&microDebugEntry=17527  拆成两个参数，值里不含 "="
+ * 后者存在的原因：部分网关/WAF 对查询串里出现第二个裸 "=" 直接返 500（整页打不开），
+ * 拆成两个参数后每个值都没有 "="，无需编码即可通过。entry 可写端口号简写。
  * 存在意义：settings.microDebugEnabled 是构建期常量、全体用户共用，生产构建里必须失效；
  * 生产环境主应用要装本机子应用，只能靠这种"按浏览器生效"的通道。
  */
 function readDebugFromUrl() {
   const href = window.location.href || "";
-  const matched = href.match(/[?&]microDebug=([^&#]*)/);
-  if (!matched) return;
-  const value = decodeURIComponent(matched[1] || "").trim();
+  const single = readUrlParam(href, "microDebug");
+  const appCode = readUrlParam(href, "microDebugAppCode");
+  const entry = readUrlParam(href, "microDebugEntry");
+  let value = null;
+  if (appCode) {
+    // 双参数写法：entry 缺省时落到默认入口（由 getDebugOverrides 补）
+    value = entry ? appCode + "=" + entry : appCode;
+  } else if (single !== null) {
+    value = single;
+  }
+  if (value === null) return;
   try {
     if (!value || value === "off" || value === "0") {
       window.localStorage.removeItem(DEBUG_STORAGE_KEY);
@@ -96,15 +125,33 @@ function readDebugFromUrl() {
     return;
   }
   try {
-    const cleaned = href
-      .replace(/([?&])microDebug=[^&#]*&?/, "$1")
-      .replace(/[?&](?=#|$)/, ""); // 抹掉后可能残留的空查询串
+    let cleaned = href;
+    DEBUG_URL_PARAMS.forEach((name) => {
+      cleaned = cleaned.replace(
+        new RegExp("([?&])" + name + "=[^&#]*&?"),
+        "$1"
+      );
+    });
+    cleaned = cleaned.replace(/[?&](?=#|$)/, ""); // 抹掉可能残留的空查询串
     window.history.replaceState(null, "", cleaned);
   } catch (e) {
     // replaceState 失败不影响开关本身，忽略
   }
 }
 
+/**
+ * entry 规范化：允许只写端口号（如 "17527"）代替完整地址。
+ * 完整地址里的 ":" 与 "//" 放在 URL 查询串上容易被地址栏或服务端重定向吃掉，
+ * 端口简写让 ?microDebug=mkweb=17527 这种最省事的写法可用。
+ */
+function normalizeDebugEntry(entry) {
+  const value = (entry == null ? "" : String(entry)).trim();
+  if (/^\d{2,5}$/.test(value)) {
+    return "http://localhost:" + value + "/";
+  }
+  return value;
+}
+
 /**
  * 本机调试覆盖，三种触发方式（localStorage 优先于 settings 开关）：
  * 1) URL 参数 ?microDebug=xx —— 任何环境（含生产构建）都生效，值写入 localStorage
@@ -127,6 +174,11 @@ function getDebugOverrides() {
     raw = null;
   }
   raw = raw ? raw.trim() : "";
+  // off / 0 一律视为关闭：与 URL 形态语义一致，
+  // 否则会被当成一个名叫 off 的 appCode 注册出去
+  if (raw === "off" || raw === "0" || raw === "false") {
+    raw = "";
+  }
   const defaults = {
     appCode: settings.microDebugAppCode || DEBUG_DEFAULT_APP_CODE,
     entry: settings.microDebugEntry || DEBUG_DEFAULT_ENTRY,
@@ -168,6 +220,10 @@ function getDebugOverrides() {
       return { appCode: code, entry };
     });
   }
+  items = items.map((item) => ({
+    appCode: item.appCode,
+    entry: normalizeDebugEntry(item.entry),
+  }));
   items = items.filter((item) => {
     if (!DEBUG_APP_CODE_REG.test(item.appCode || "") || !item.entry) {
       console.error(
@@ -190,6 +246,8 @@ function applyDebugOverrides(apps) {
     if (existing) {
       existing.entry = override.entry;
       existing.enabled = true;
+      // 打标记：子应用据此启用"URL 直达未配菜单页面"的调试兜底路由
+      existing.debugOverride = true;
     } else {
       result.push({
         appCode: override.appCode,
@@ -197,6 +255,7 @@ function applyDebugOverrides(apps) {
         entry: override.entry,
         hasCorejs: true,
         enabled: true,
+        debugOverride: true,
       });
     }
     console.warn(
@@ -256,6 +315,8 @@ export function registerSubApps(apps, options = {}) {
         lang: localStorage.getItem("i18n-lang") || "",
         userInfo,
         mainAdapter,
+        // 本地调试覆盖装载的应用：允许 URL 直达未配菜单的页面（见 permission.js 调试兜底路由）
+        microDebug: !!app.debugOverride,
       },
     };
   });

package/src/store/modules/micro.js

@@ -14,6 +14,9 @@ const state = {
   selfManaged: false,
   // 保活隐藏期间置 true：路由守卫直接 next(false)，防止隐藏的子应用响应主应用的 URL 变化
   routerPaused: false,
+  // 主应用经本地调试覆盖装载本应用时为 true：启用"URL 直达未配菜单页面"的兜底路由。
+  // 正式注册表装载时为 false——菜单即权限边界，不能让任意路径都能打开组件
+  debug: false,
 };
 
 const mutations = {
@@ -24,6 +27,7 @@ const mutations = {
     state.menus = payload.menus || [];
     state.mainAdapter = payload.mainAdapter || null;
     state.lang = payload.lang || "";
+    state.debug = !!payload.debug;
   },
   SET_ROUTER_PAUSED: (state, paused) => {
     state.routerPaused = !!paused;
@@ -36,6 +40,7 @@ const mutations = {
     state.lang = "";
     state.selfManaged = false;
     state.routerPaused = false;
+    state.debug = false;
   },
 };
 

package/src/store/modules/permission.js

@@ -21,6 +21,44 @@ import MenuFallback from "@base/views/user/menuFallback/index.vue";
 let hostRegistryApps = [];
 let hostMicroRoutes = [];
 
+// 子应用被"本地调试覆盖"装载时置 true：启用按访问路径直接解析组件的兜底路由，
+// 使联调期可用 URL 直达尚未配置菜单的页面。正式注册表装载时恒为 false——
+// 菜单即权限边界，不能让任意路径都能打开组件
+let debugPathEnabled = false;
+
+// 按路径解析出的异步组件工厂按路径缓存：Vue 2 依工厂函数标识做结果缓存，
+// 每次 render 新建工厂会导致重复请求同一 chunk
+let debugPathFactories = {};
+
+/**
+ * 调试兜底路由：把当前访问路径当作菜单 url 走同一套组件解析
+ * （剥归属前缀 → /base 命名空间 → loadView），解析不出则落 menuFallback 提示页。
+ */
+function createDebugPathRoute() {
+  return {
+    path: "*",
+    name: "microDebugPath",
+    meta: { title: "调试直达", microDebugPath: true },
+    component: {
+      name: "microDebugPathView",
+      render(h) {
+        const path = (this.$route && this.$route.path) || "";
+        const componentPath = resolveComponentPath(
+          { url: path },
+          settings.appCode || ""
+        );
+        if (!componentPath) {
+          return h(MenuFallback, { props: { componentPath: path } });
+        }
+        if (!debugPathFactories[componentPath]) {
+          debugPathFactories[componentPath] = loadView(componentPath);
+        }
+        return h(debugPathFactories[componentPath], { key: path });
+      },
+    },
+  };
+}
+
 // 下发给子应用的登录信息快照（props.userInfo，协议第 5 节）；注册时快照，非实时
 function buildUserInfoSnapshot(userState = {}) {
   return {
@@ -221,7 +259,9 @@ const actions = {
     });
   },
   // qiankun 子应用模式：主应用经 props 下发菜单，替代 getRouters 自拉
-  generateRoutesFromProps({ dispatch }, menus = []) {
+  generateRoutesFromProps({ dispatch, rootState }, menus = []) {
+    // 调试覆盖装载时允许 URL 直达未配菜单的页面（handleMenuRoutes 追加兜底路由）
+    debugPathEnabled = !!(rootState.micro && rootState.micro.debug);
     return dispatch("setSidebarRoute", menus);
   },
   setSidebarRoute({ commit, dispatch }, rows = []) {
@@ -285,6 +325,11 @@ function handleMenuRoutes(routes) {
     children.push(microRoute);
   });
 
+  // 调试兜底放在全局 * → /404 之前，未配菜单的路径由它按路径解析组件
+  if (debugPathEnabled) {
+    children.push(createDebugPathRoute());
+  }
+
   sidebarRoutes.children = children;
   var result = [sidebarRoutes];
   result.push({