service 回跳信息对齐 Java notice 分号矩阵段形态：{path};redirectToReferer=<hex>[?query]（弃 query 形态，回调经路径分号段解析；query 旧形态仍兼容读取）

src/YhCore.WebApi/Auth/Cas/CasAuthenticationHandler.cs

@@ -19,14 +19,16 @@ namespace YhCore.WebApi.Auth
     /// <item>Challenge：302 到 CAS 登录页，service = {AppBaseUrl}{当前 path}[?除 ticket 外 query]，即原访问 URL，
     ///       与 Java notice 的 service 形态一致（service=http://host/module/api/xxx）；AppBaseUrl 含模块前缀
     ///       （如 /docprint）时拼接结果天然带模块名。显式回跳语境（前端 yschreferer/Referer 携带页面地址）时
-    ///       在该 service 上追加 query 参数 redirectToReferer=&lt;hex(回跳地址)&gt; 携带「登录后回页面」信息——
-    ///       不再以 {SignInCallbackPath} 回调端点作 service（signin-cas 形态已弃用）；hex 按 char 维度编码
-    ///       （对齐前端 strToHexCharCode / Java HexUtils），避免 query 内嵌完整 URL 需多层 urlencode。
-    ///       ASP.NET Core 无 Java 路径矩阵参数机制，回跳目标只能放 query。</item>
+    ///       把回跳地址以 Java notice 同款分号矩阵段插入 path 与 query 之间：
+    ///       {path};redirectToReferer=&lt;hex(回跳地址)&gt;[?{原 query}]——不再以 {SignInCallbackPath} 回调端点作
+    ///       service（signin-cas 形态已弃用）；hex 按 char 维度编码（对齐前端 strToHexCharCode / Java HexUtils），
+    ///       分号段不参与 query 结构，含中文/特殊字符的页面地址也可无歧义承载。ASP.NET Core 对回调中分号段
+    ///       的处理：带 ticket 校验成功后由中间件短路（不落 MVC 路由），路径分号段仅用于解析回跳目标。</item>
     /// <item>Authenticate：任意受保护路径带 ticket 的回调均按「path + 除 ticket 外的 query」重建 service
-    ///       调 /serviceValidate 校验（service 即登录时的原访问 URL，CAS 在末尾追加 ?ticket=/&amp;ticket= 回跳）。
-    ///       成功后写入 Cookie 登录态并 302 到 redirectToReferer（hex 解码，当前形态）/ returnUrl（旧中继形态
-    ///       兼容）/ 原 URL 去 ticket 版（无回跳目标），兼容更早的 ;redirectToReferer=&lt;hex&gt; 路径段形态。</item>
+    ///       调 /serviceValidate 校验（service 即登录时的原访问 URL，含分号段则一并重建，CAS 在末尾追加
+    ///       ?ticket=/&amp;ticket= 回跳）。成功后写入 Cookie 登录态并 302 到分号段 redirectToReferer（hex 解码，
+    ///       当前形态）/ query redirectToReferer（旧 query 形态兼容）/ returnUrl（更早中继形态兼容）/
+    ///       原 URL 去 ticket 版（无回跳目标）。</item>
     /// </list>
     /// </summary>
     public class CasAuthenticationHandler : AuthenticationHandler<CasAuthenticationOptions>
@@ -36,7 +38,8 @@ namespace YhCore.WebApi.Auth
         /// <summary>旧中继形态（service={回调端点}?returnUrl=…）的回跳参数——已弃用，仅兼容历史 URL/缓存。</summary>
         private const string ReturnUrlParam = "returnUrl";
 
-        /// <summary>当前形态回跳参数：service=原访问 URL 时追加 ?redirectToReferer=&lt;hex(回跳地址)&gt;，登录后 CAS 原样回带。</summary>
+        /// <summary>旧 query 形态（service=原访问 URL?redirectToReferer=&lt;hex&gt;，986b241 曾用）的回跳参数——
+        /// 已改分号矩阵段承载，此处仅兼容读取历史 URL/缓存。</summary>
         private const string RedirectToRefererQueryParam = "redirectToReferer";
 
         private readonly CasServiceTicketValidator _validator;
@@ -128,13 +131,18 @@ namespace YhCore.WebApi.Auth
         else
         {
             // 显式回跳语境（前端 yschreferer 携带页面地址等）：service 仍 = 原访问 URL（notice 形态，
-            // 不再以 {SignInCallbackPath} 回调端点作 service），仅追加 query 参数
-            // redirectToReferer=<hex(回跳地址)> 携带「登录后回页面」信息——CAS 会把它作为 service 一部分
-            // 在回调时原样带回，本 handler 校验成功后 hex 解码即得回跳目标。hex 按 char 维度编码，避免
-            // query 内嵌完整 URL 需多层 urlencode（对齐前端 strToHexCharCode / Java HexUtils）。
+            // 不再以 {SignInCallbackPath} 回调端点作 service），把回跳地址以 Java notice 同款的分号矩阵段
+            // 形式插入 path 与 query 之间：{path};redirectToReferer=<hex>[?{原 query}]——CAS 会把它作为
+            // service 一部分在回调时原样带回，本 handler 校验成功后由 ParseRedirectToReferer 从路径段
+            // hex 解码即得回跳目标（query 形态 ?redirectToReferer=<hex> 的旧 URL/缓存仍兼容读取）。
+            // hex 按 char 维度编码（对齐前端 strToHexCharCode / Java HexUtils）；分号段内不参与 query 结构，
+            // 含中文/特殊字符的页面地址也可无歧义承载。
             service = BuildServiceUrlFromRequest();
-            service += (service.IndexOf('?') < 0 ? "?" : "&")
-                       + RedirectToRefererQueryParam + "=" + HexEncode(target);
+            var q = service.IndexOf('?');
+            var segment = RedirectToRefererMarker + HexEncode(target);
+            service = q < 0
+                ? service + segment
+                : service.Substring(0, q) + segment + service.Substring(q);
         }
         // Uri.EscapeDataString 会把 ; / : = 全部编码（%3B/%2F/%3A/%3D），与平台旧版系统生成的
         // CAS 登录 URL 逐字节一致（UrlEncoder.Encode 会保留 ; 字面量）

src/YhCore.WebApi/Middleware/SsoProtectionMiddleware.cs

@@ -111,8 +111,9 @@ namespace YhCore.WebApi.Middleware
 
         /// <summary>
         /// 触发 Challenge 生成 CAS 登录地址（service 构造由本地化 CasAuthenticationHandler 完成：
-        ///   service 恒为原访问 URL（notice 形态）；显式回跳（yschreferer/Referer）时仅在其上追加
-        ///   redirectToReferer=&lt;hex&gt; query，不再以 SignInCallbackPath 回调端点作 service）。
+        ///   service 恒为原访问 URL（notice 形态）；显式回跳（yschreferer/Referer）时以 Java notice 同款
+        ///   分号矩阵段 ;redirectToReferer=&lt;hex&gt; 插入 path 与 query 之间，不再以 SignInCallbackPath
+        ///   回调端点作 service）。
         /// 受保护 API 的 AJAX/XHR 请求：拦截框架写入的 302 + Location，改写为 200 + JSON，避免 XHR
         /// 跟随跨域 302 跳转 CAS 登录页时被 CORS 拦截；文档导航 / 根路径 / 回调仍保持 302。
         /// </summary>
@@ -127,9 +128,9 @@ namespace YhCore.WebApi.Middleware
             //     （null）→ handler 以纯净"原访问 URL"作 service（notice 形态 service=http://host/module/api/xxx），
             //     登录后 CAS 回跳原 URL+ticket，由 handler 校验并 302 去掉 ticket 落回原地址；
             //   - 显式回跳语境（前端 yschreferer 打标携带页面地址 / Referer）：回跳目标 = 页面地址，
-            //     handler 仍以原访问 URL 作 service 主体并追加 ?redirectToReferer=&lt;hex(目标)&gt; 携带回页面
-            //     信息（ASP.NET Core 无 Java 路径矩阵参数机制，只能放 query）——前端登录后回到所在页面
-            //     而非接口本身；
+            //     handler 仍以原访问 URL 作 service 主体，并把目标以分号矩阵段 ;redirectToReferer=&lt;hex&gt;
+            //     插入 path 与 query 之间（与 Java notice 同款；分号段不参与 query 结构，目标含中文/特殊
+            //     字符也无歧义）——前端登录后回到所在页面而非接口本身；
             //   - 回调路径直访防呆（访问的恰是回调端点自身且无 ticket 未认证、无打标）：回 "/"，
             //     避免登录后回跳回调自身再触发 Challenge（前端打标场景仍回前端页——回调路径本身常是前端
             //     登录检测接口 /api/base/GetUserInfo，必须回到用户所在页面）。