, status: number): T {
return res.data ?? (null as T);
case 302:
console.log(res);
+ // 后端 CAS 门已拼好登录地址（含 service=会话建立端点），整页跳过去即可。
+ // 跳转前记下当前地址：固定 service 的回跳只能落默认页，hash 页签靠前端记账换回
+ //（原因见 utils/ssoReturn.ts——不能照 Notice 把 hex 拼进固定 service）。
+ // 跳转后返回永不 resolve 的挂起 Promise：调用方 await 悬停，全局 onBizError 与
+ // 各页面 catch 都不再触发——否则会弹一个"redirect"错误提示（Notice 同款处理）。
+ rememberReturnUrl();
window.location.href = res.urlToRedirectTo!;
- throw new Error("redirect");
+ return new Promise(() => {}) as T;
case 4:
throw new Error(res.msg || "参数错误!");
default:
@@ -90,8 +97,11 @@ export function createBschAlova(baseURL: string, hooks: RequestHooks = {}, state
injectHeaders(method);
method.config.credentials = "include";
- // 通用头（网关管理面不识别 yschapirequest/yschreferer/currentRole，故不注入）
+ // 通用头。yschapirequest 是治理面 CAS 门识别 SPA 的标记头（与平台
+ // CasSsoApiRedirectFilter 同名同值）：带它，未登录才返回 200+{code:302,urlToRedirectTo}
+ // 让本页去整页跳 SSO；不带，网关按裸调用方出 401 json。
method.config.headers = Object.assign(method.config.headers || {}, {
+ yschapirequest: "1",
timeout: 20000,
});
}
diff --git a/src/utils/ssoReturn.ts b/src/utils/ssoReturn.ts
new file mode 100644
index 0000000..a2c7349
--- /dev/null
+++ b/src/utils/ssoReturn.ts
@@ -0,0 +1,48 @@
+/**
+ * SSO 登录往返的「回到原页签」记账（纯前端）。
+ *
+ * 为什么不是 Notice 的 {@code ;redirectToReferer=} 那套：Notice 把 hex 拼进 service
+ * 参数，再靠校验过滤器从实时请求 URI 重算出同一个带 hex 的 service，两端逐字节一致才过得了
+ * CAS 的 ST 比对。本网关的 ctx 为空、外链前缀 {@code /open-gateway} 由 Caddy 剥掉，容器算不出
+ * 带前缀的地址，只能改用固定 service（见后端 {@code SsoAddressing}）——固定值里塞不进每次
+ * 不同的 hex：登录时 service 带 A、校验时 service 是常量，CAS 判定 service 不一致 → 票据校验必失败
+ * → 又是一次 302，死循环。
+ *
+ * 所以回跳目标不下服务端：整页跳去登录前把它记在 {@code sessionStorage}（同标签页、跨站点往返仍在），
+ * 回到控制台壳页时读出来换回原页签。副作用为零，且不引入任何服务端开放重定向面。
+ */
+
+const RETURN_KEY = "ysch-return-url";
+
+/** 整页跳去 SSO 之前调用：记下当前控制台地址（含 hash 路由） */
+export function rememberReturnUrl(href: string = window.location.href): void {
+ try {
+ sessionStorage.setItem(RETURN_KEY, href);
+ } catch (e: any) {
+ // 隐私模式/配额满：最坏只是回到默认页，不影响登录本身
+ }
+}
+
+/**
+ * 取出并清掉回跳目标，返回 vue-router 的 hash 路由段（如 {@code /ledger?pageIndex=2}）。
+ * 只认「同 origin + 同一壳页」的地址，其余一律丢弃——防把用户导向站外或别的应用。
+ */
+export function consumeSsoReturnUrl(): string | null {
+ let raw: string | null = null;
+ try {
+ raw = sessionStorage.getItem(RETURN_KEY);
+ if (raw) sessionStorage.removeItem(RETURN_KEY);
+ } catch (e: any) {
+ return null;
+ }
+ if (!raw) return null;
+ try {
+ const u = new URL(raw);
+ if (u.origin !== window.location.origin) return null;
+ if (u.pathname !== window.location.pathname) return null;
+ const route = u.hash.replace(/^#\/?/, "/");
+ return route && route !== "/" ? route : null;
+ } catch (e: any) {
+ return null;
+ }
+}