Refine play type integration flow and docs

server-rs/crates/api-server/src/state.rs

@@ -591,7 +591,7 @@ impl AppState {
         )
         .map_err(|_| SpacetimeClientError::Runtime("认证快照更新时间超出 i64 范围".to_string()))?;
         // 当前进程内 auth_store 是认证请求的即时工作集；SpacetimeDB 正式认证表用于跨进程恢复。
-        // 远端数据库挂起或网络异常时，只降级后续恢复能力，不能让已成功的登录/刷新/退出回滚为失败。
+        // 认证变更必须在返回客户端前写入 SpacetimeDB，避免只在本进程内成功、重启后丢失账号或会话。
         #[cfg(not(test))]
         if let Err(error) = self
             .spacetime_client
@@ -600,9 +600,9 @@ impl AppState {
         {
             warn!(
                 error = %error,
-                "认证快照导入 SpacetimeDB 正式表失败，当前认证流程继续"
+                "认证快照导入 SpacetimeDB 正式表失败，当前认证流程中止"
             );
-            return Ok(());
+            return Err(error);
         }
         #[cfg(not(test))]
         Ok(())