@lark-apaas/coding-template-nestjs-react-fullstack 0.1.52-alpha.20261027080311 → 0.1.52-alpha.20261027082821

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-template-nestjs-react-fullstack",
-  "version": "0.1.52-alpha.20261027080311",
+  "version": "0.1.52-alpha.20261027082821",
   "description": "NestJS + React fullstack template for miaoda coding",
   "type": "module",
   "files": [

package/template/client/src/components/business-ui/api/user-profiles/queries.ts

@@ -10,7 +10,13 @@ export const userProfileQueries = {
     queryOptions({
       queryKey: [...userProfileQueries.all(), 'byId', accountType, userId],
       queryFn: ({ signal }) => fetchUserProfile(userId, accountType, signal),
-      staleTime: 1 * 60 * 1000,
+      // staleTime 0：每次打开都在后台取一次新的，和飞书名片那条路保持一致
+      // ——「打开渲染缓存、后台乐观更新」。缓存命中时 isPending 为 false，
+      // 卡片瞬间渲出不转圈；新数据回来后 React 只 patch 变化的字段，不闪不跳。
+      //
+      // 之前是 60s：那段窗口内连请求都不发，远端改了最多要等 60 秒才看得到。
+      staleTime: 0,
+      // gcTime 决定缓存能留多久 —— 它才是「秒出」的来源，不要跟着一起调小。
       gcTime: 5 * 60 * 1000,
       enabled: !!userId,
     }),

package/template/client/src/components/business-ui/user-profile/user-profile.tsx

@@ -400,7 +400,13 @@ function LarkProfileCard(props: { readonly larkCardParam: LarkCardParam }) {
       // 有备用卡顶着就离屏渲染（用户看不到骨架屏），没有就直接渲进可见容器。
       void ensureRender(`${targetLarkOpenID}:update`, () => renderInto(!spare))
         .then((live) => {
-          if (cancelled) return;
+          if (cancelled) {
+            // 组件已卸载（用户在新卡渲染完成前关掉了弹窗）。此时元素已经被
+            // renderInto 挪进常驻的离屏容器，既不会被 attach，也不进受
+            // maxEntries 约束的备用卡池 —— 放着不管就会随着反复开关一直累积。
+            live?.remove();
+            return;
+          }
           if (live) {
             attach(live);
             return;