Skip to content

feat(network): Stage-5c+5d 跨服玩家路由 + player_route + SessionManager 钩子 - #497

Merged
AlianBlank merged 3 commits into
mainfrom
feature/auto-server-source-worker-run-7775-20260922T0700
Sep 22, 2026
Merged

AlianBlank merged 3 commits into
mainfrom
feature/auto-server-source-worker-run-7775-20260922T0700

Conversation

@AlianBlank

Copy link
Copy Markdown
Collaborator

概要

C143e(Stage-5c+5d 跨服玩家路由)落地:player_route 控制库集合 + IPlayerRouteResolver 三级查找 + Mongo 版本 CAS 同步 + 信封接收端 LocalEnvelopeDispatcher + SessionManager 同步钩子。

3 个原子提交:

  • 4af48cb feat(network): 玩家路由核心层装配
  • 32b1ba5 feat(apps): SessionManager 同步钩子与启动接线
  • 61b5daf test(player-route): 三级查找与 CAS upsert 单元/集成用例

关键决策

  • 反向依赖解耦:IPlayerRouteFastPath 接口定义在 RemoteMessaging 包内,SessionManagerFastPathAdapter 在 Apps 包内实现,避免 RemoteMessaging 反向依赖 GameFrameX.Apps
  • LocalEnvelopeDispatcher 使用 IPlayerLocalSender:原方案 Actor 后端 dispatcher 改为按 InnerMessageId 还原类型 + 反序列化后直接调 IPlayerLocalSender.SendToLocalPlayerAsync,等价于既有 ReqSendToPlayerInner 接收路径
  • 不为 envelope 新增发送入口:UnifiedMessageSender.FowardToRemoteServerAsync 私有方法已走 RPC 链完成 AC-4b 端到端语义,本 change 不引入第二条路径
  • PerInstanceDedupe 1 秒窗口:注释说明基于 RetrySemantics 指数退避起点选窗

验证

  • dotnet build Server.slnx:通过
  • 单元测试 7/7 绿(IPlayerRouteFastPath / PlayerRouteInfo / NullPlayerRouteSyncTarget)
  • Mongo 集成测试 8/8 绿(SyncTarget 首登 / CAS 成功 / CAS 失败抛 PlayerRouteStaleException / Delete / 索引断言 / Resolver 三级查找)
  • GameFrameX.Hotfix.Tests 55/55 绿
  • GameFrameX.Tests 1284/1285 绿(1 个 GlobalSettingsSettingConflictTests 为 main 基线已知问题,与本 PR 无关)

变更文件

GameFrameX.NetWork.RemoteMessaging/Routing/IPlayerRouteFastPath.cs         (new)
GameFrameX.NetWork.RemoteMessaging/Routing/IPlayerRouteResolver.cs        (new)
GameFrameX.NetWork.RemoteMessaging/Routing/IPlayerRouteSyncTarget.cs       (new)
GameFrameX.NetWork.RemoteMessaging/Routing/NullPlayerRouteSyncTarget.cs    (new)
GameFrameX.NetWork.RemoteMessaging/Routing/LocalEnvelopeDispatcher.cs      (new)
GameFrameX.NetWork.RemoteMessaging/Routing/MongoPlayerRouteResolver.cs     (new)
GameFrameX.NetWork.RemoteMessaging/Routing/MongoPlayerRouteResolverBootstrap.cs (new)
GameFrameX.NetWork.RemoteMessaging/Routing/MongoPlayerRouteSyncTarget.cs   (new)
GameFrameX.NetWork.RemoteMessaging/Routing/PerInstanceDedupe.cs            (new)
GameFrameX.NetWork.RemoteMessaging/Routing/PlayerRouteCollection.cs        (new)
GameFrameX.NetWork.RemoteMessaging/Routing/PlayerRouteInfo.cs              (new)
GameFrameX.NetWork.RemoteMessaging/Routing/PlayerRouteStaleException.cs    (new)
GameFrameX.NetWork.RemoteMessaging/Routing/RoleRouteEnvelopeMessage.cs     (mod: MessageTypeHandler)
GameFrameX.NetWork.RemoteMessaging/Routing/RoleRouterHolder.cs             (mod: IsInitialized)
GameFrameX.NetWork.RemoteMessaging/Discovery/MongoDiscoveryRuntime.cs     (mod: Activate fastPath)
GameFrameX.Apps/Common/Session/SessionManager.cs                           (mod: SyncTarget hook)
GameFrameX.Apps/Common/Session/SessionManagerFastPathAdapter.cs            (new)
GameFrameX.Apps/GameFrameX.Apps.csproj                                     (mod: ProjectReference)
GameFrameX.Launcher/StartUp/AppStartUpGame.cs                              (mod: Activate 调用)
GameFrameX.Launcher/StartUp/Social/AppStartUpSocial.cs                     (mod: Activate 调用)
Tests/GameFrameX.Tests/Discovery/MongoPlayerRouteResolverTests.cs          (new)
Tests/GameFrameX.Tests/Discovery/MongoPlayerRouteIntegrationTests.cs       (new)

在 NetWork.RemoteMessaging 包内实现跨服玩家路由层(C143e D21):
player_route 控制库集合 + IPlayerRouteResolver 三级查找接口 + Mongo
版本 CAS 同步目标 + 装配入口 + 信封接收端 LocalEnvelopeDispatcher。
新增 IPlayerRouteFastPath 反向依赖解耦缝,避免 RemoteMessaging 引用
GameFrameX.Apps。MongoDiscoveryRuntime.Activate 末尾追加 Bootstrap 装配。
RoleRouteEnvelopeMessage 启用 MessageTypeHandler 特性;RoleRouterHolder
暴露 IsInitialized。PerInstanceDedupe 提供跨服投递 1 秒单飞窗口。
GameFrameX.Apps 项目新增 SessionManagerFastPathAdapter 把内存态
PlayerRouteMap 暴露为 IPlayerRouteFastPath;SessionManager 暴露
PlayerRouteSyncTarget 静态注入点,SetPlayerRouteOnline/Offline 在
内存态落定后调用钩子(失败 swallow + warning,主链路不挂)。
GameFrameX.Apps.csproj 新增 NetWork.RemoteMessaging 引用。
AppStartUpGame/Social 调用 Activate 时传入 fast-path 适配器,并把
MongoPlayerRouteResolverBootstrap 暴露的 SyncTarget 注入 SessionManager。
Tests/GameFrameX.Tests 新增 MongoPlayerRouteResolverTests 单元用例:
IPlayerRouteFastPath 在线/离线/错玩家分支 + PlayerRouteInfo 工厂 +
NullPlayerRouteSyncTarget NoOp 验证(7 用例)。
MongoPlayerRouteIntegrationTests Mongo 集成:SyncTarget 首登 upsert
/ CAS 成功 / CAS 失败抛 PlayerRouteStaleException / Delete / 索引
(playerId 唯一 + lastSeenAt TTL 30 天)断言 / Resolver Tier 1 命中
/Tier 2 命中/全 miss 返回 Offline 三路径(8 用例,沿用 GAMEFRAMEX_TEST_
MONGODB_CONNECTION_STRING 门控)。
@coderabbitai

coderabbitai Bot commented Sep 22, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 53 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 47fdabb5-607b-4821-a090-35869de2329f

📥 Commits

Reviewing files that changed from the base of the PR and between bdda090 and 61b5daf.

📒 Files selected for processing (22)
  • GameFrameX.Apps/Common/Session/SessionManager.cs
  • GameFrameX.Apps/Common/Session/SessionManagerFastPathAdapter.cs
  • GameFrameX.Apps/GameFrameX.Apps.csproj
  • GameFrameX.Launcher/StartUp/AppStartUpGame.cs
  • GameFrameX.Launcher/StartUp/Social/AppStartUpSocial.cs
  • GameFrameX.NetWork.RemoteMessaging/Discovery/MongoDiscoveryRuntime.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/IPlayerRouteFastPath.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/IPlayerRouteResolver.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/IPlayerRouteSyncTarget.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/LocalEnvelopeDispatcher.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/MongoPlayerRouteResolver.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/MongoPlayerRouteResolverBootstrap.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/MongoPlayerRouteSyncTarget.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/NullPlayerRouteSyncTarget.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/PerInstanceDedupe.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/PlayerRouteCollection.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/PlayerRouteInfo.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/PlayerRouteStaleException.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/RoleRouteEnvelopeMessage.cs
  • GameFrameX.NetWork.RemoteMessaging/Routing/RoleRouterHolder.cs
  • Tests/GameFrameX.Tests/Discovery/MongoPlayerRouteIntegrationTests.cs
  • Tests/GameFrameX.Tests/Discovery/MongoPlayerRouteResolverTests.cs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@sonarqubecloud

Copy link
Copy Markdown

@AlianBlank
AlianBlank merged commit f398f0f into main Sep 22, 2026
2 of 3 checks passed
@AlianBlank
AlianBlank deleted the feature/auto-server-source-worker-run-7775-20260922T0700 branch September 22, 2026 07:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant