@taicode/common-server 4.0.0-beta.2 → 4.0.0-beta.3

package/output/app/boot.d.ts

@@ -27,13 +27,18 @@ export interface BootedServer<R, S> {
  * 步序（N1 §5）：
  * ```
  * 1. 加载 env（框架固定，调用方已做）        → env
- * 2. resources(ctx={env,log})                → R（只构造，不建连）
- * 3. config(ctx={env,log,resources})         → C（仅 start 路径；出 spec 路径不跑）
+ * 2. resources(ctx={env,log,disposer})        → R（只构造，不建连）
+ * 3. config(ctx={env,log,disposer,resources}) → C（仅 start 路径；出 spec 路径不跑）
  * 4. services(ctx={log,disposer,resources,config}) → S，随后按声明序 init()（仅 start 路径）
- * 5. middlewares(ctx={app,log,services,config})    → 按数组序 register(app)
- * 6. routers(ctx={app,log,services})               → 注册路由
+ * 5. middlewares(ctx={app,log,disposer,services,config}) → 按数组序 register(app)
+ * 6. routers(ctx={app,log,disposer,services})           → 注册路由
  * 7. ready / listen
  * ```
+ *
+ * **每个阶段一个独立 `Disposer`**（构造处注册释放）；关闭时按阶段**逆序 flush**
+ * `routers → middlewares → services → config → resources`（services 阶段内部先 flush 自己的
+ * `disposer`，再逐单元逆序 `dispose`）。资源因此**最后**才断：service 关闭时若还要落库不会
+ * 撞死连接。出 spec 路径不关闭，也不执行任何 flush。
  */
 export declare function bootServer<R, C, S>(input: BootInput<R, C, S>): Promise<BootedServer<R, S>>;
 //# sourceMappingURL=boot.d.ts.map

package/output/app/boot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../source/app/boot.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACtG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,UAAU,CAAA;AACvC,eAAO,MAAM,kBAAkB,YAAY,CAAA;AAC3C,mBAAmB;AACnB,MAAM,MAAM,SAAS,GAAG,OAAO,gBAAgB,GAAG,OAAO,kBAAkB,CAAA;AAC3E,aAAa;AACb,eAAO,MAAM,YAAY,YAAY,CAAA;AAErC,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACvB,GAAG,EAAE,SAAS,CAAA;IACd,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,CAAC;IAChC,GAAG,EAAE,eAAe,CAAA;IACpB,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC3B,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAqCD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CA6GhG"}
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../source/app/boot.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACtG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,UAAU,CAAA;AACvC,eAAO,MAAM,kBAAkB,YAAY,CAAA;AAC3C,mBAAmB;AACnB,MAAM,MAAM,SAAS,GAAG,OAAO,gBAAgB,GAAG,OAAO,kBAAkB,CAAA;AAC3E,aAAa;AACb,eAAO,MAAM,YAAY,YAAY,CAAA;AAErC,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACvB,GAAG,EAAE,SAAS,CAAA;IACd,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,CAAC;IAChC,GAAG,EAAE,eAAe,CAAA;IACpB,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC3B,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAqCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CA6HhG"}

package/output/app/boot.js

@@ -1,7 +1,7 @@
 import { Disposer } from '@taicode/common-base';
 import { createConfigContext, createConfigHolder, createMiddlewareContext, createResourcesContext, createRouterContext, createServiceContext, createShutdownContext, liveResources, readConfigKey, requireConfig, } from './context.js';
 import { createFastify, registerCore } from './core/index.js';
-import { disposeServices, initServiceUnits, MIDDLEWARES_LOG_STAGE, middlewareUnitName } from './lifecycle.js';
+import { CONFIG_STAGE, disposeServices, disposeStage, initServiceUnits, MIDDLEWARES_LOG_STAGE, MIDDLEWARES_STAGE, middlewareUnitName, RESOURCES_STAGE, ROUTERS_STAGE, SERVICES_STAGE, } from './lifecycle.js';
 import { runShutdown } from './shutdown.js';
 import { attachSignalHandlers } from './signal.js';
 /** 内部步序（`prepare` → `compose` → `activate`）：`startServer` / `generateOpenApi` 共用。 */
@@ -48,13 +48,18 @@ function combineClassifiers(classifiers) {
  * 步序（N1 §5）：
  * ```
  * 1. 加载 env（框架固定，调用方已做）        → env
- * 2. resources(ctx={env,log})                → R（只构造，不建连）
- * 3. config(ctx={env,log,resources})         → C（仅 start 路径；出 spec 路径不跑）
+ * 2. resources(ctx={env,log,disposer})        → R（只构造，不建连）
+ * 3. config(ctx={env,log,disposer,resources}) → C（仅 start 路径；出 spec 路径不跑）
  * 4. services(ctx={log,disposer,resources,config}) → S，随后按声明序 init()（仅 start 路径）
- * 5. middlewares(ctx={app,log,services,config})    → 按数组序 register(app)
- * 6. routers(ctx={app,log,services})               → 注册路由
+ * 5. middlewares(ctx={app,log,disposer,services,config}) → 按数组序 register(app)
+ * 6. routers(ctx={app,log,disposer,services})           → 注册路由
  * 7. ready / listen
  * ```
+ *
+ * **每个阶段一个独立 `Disposer`**（构造处注册释放）；关闭时按阶段**逆序 flush**
+ * `routers → middlewares → services → config → resources`（services 阶段内部先 flush 自己的
+ * `disposer`，再逐单元逆序 `dispose`）。资源因此**最后**才断：service 关闭时若还要落库不会
+ * 撞死连接。出 spec 路径不关闭，也不执行任何 flush。
  */
 export async function bootServer(input) {
     const { server, env, phase } = input;
@@ -65,7 +70,14 @@ export async function bootServer(input) {
     const app = createFastify(env);
     const instance = app;
     const log = app.log;
-    const disposer = new Disposer();
+    // 每个阶段一个 Disposer：创建与释放同处一地，关闭时按阶段逆序 flush
+    const disposers = {
+        resources: new Disposer(),
+        config: new Disposer(),
+        services: new Disposer(),
+        middlewares: new Disposer(),
+        routers: new Disposer(),
+    };
     const holder = createConfigHolder();
     // ② resources：只构造，不建连（出 spec 路径同样执行）
     //    资源错误分类器由各资源通过 `ctx.registerClassifyError` 各自注册：在调 `resources(ctx)` 前建局部收集器，
@@ -74,6 +86,7 @@ export async function bootServer(input) {
     const resources = (await server.resources(createResourcesContext({
         env,
         log,
+        disposer: disposers.resources,
         registerClassifyError: (classifier) => {
             classifiers.push(classifier);
         },
@@ -89,12 +102,12 @@ export async function bootServer(input) {
     // ── compose ──────────────────────────────────────────────────────────────
     // ① config（仅 start 路径；出 spec 路径不跑 → `ctx.config` 读到即抛 CONFIG_UNAVAILABLE）
     if (isStart) {
-        holder.current = (await server.config(createConfigContext({ env, log, resources: resourcesView })));
+        holder.current = (await server.config(createConfigContext({ env, log, disposer: disposers.config, resources: resourcesView })));
     }
     // ② services（两个入口都执行；ctx 无 env、无 services）
     const services = server.services(createServiceContext({
         log,
-        disposer,
+        disposer: disposers.services,
         resources: resourcesView,
         holder,
     }));
@@ -103,20 +116,21 @@ export async function bootServer(input) {
         await initServiceUnits({ service, log, services: services });
     }
     // ④ middlewares（两个入口都执行：出 spec 也照注册，保证 schema 一致）
-    const middlewares = server.middlewares(createMiddlewareContext({ app: instance, log, services, holder }));
+    const middlewares = server.middlewares(createMiddlewareContext({ app: instance, log, disposer: disposers.middlewares, services, holder }));
     for (const [index, unit] of middlewares.entries()) {
         await unit.register(instance);
         log.debug({ service, unit: middlewareUnitName(service, unit, index), stage: MIDDLEWARES_LOG_STAGE }, '[middleware] registered');
     }
     // ⑤ routers（两个入口都执行）
-    await server.routers(createRouterContext({ app: instance, log, services }));
+    await server.routers(createRouterContext({ app: instance, log, disposer: disposers.routers, services }));
     // ── activate ─────────────────────────────────────────────────────────────
     const runShutdownFlow = async () => {
         if (input.shutdown) {
+            // 整体覆盖：自定义 shutdown 自行负责各阶段 flush（框架不再代劳）
             await input.shutdown(createShutdownContext({
                 app: instance,
                 log,
-                disposer,
+                disposer: disposers.services,
                 resources: resourcesView,
                 holder,
                 services,
@@ -124,8 +138,12 @@ export async function bootServer(input) {
             return;
         }
         await runShutdown({
-            stopProducers: () => disposer.dispose(),
+            flushRouters: () => disposeStage({ service, log, stage: ROUTERS_STAGE, disposer: disposers.routers }),
+            flushMiddlewares: () => disposeStage({ service, log, stage: MIDDLEWARES_STAGE, disposer: disposers.middlewares }),
+            flushServices: () => disposeStage({ service, log, stage: SERVICES_STAGE, disposer: disposers.services }),
             disposeServices: () => disposeServices({ service, log, services: services }),
+            flushConfig: () => disposeStage({ service, log, stage: CONFIG_STAGE, disposer: disposers.config }),
+            flushResources: () => disposeStage({ service, log, stage: RESOURCES_STAGE, disposer: disposers.resources }),
         }, log);
     };
     app.addHook('onClose', () => runShutdownFlow());

package/output/app/context.d.ts

@@ -23,6 +23,7 @@ export declare function readConfigKey(config: unknown, key: string): unknown;
 export interface ResourcesContextParams {
     env: ConfigEnv;
     log: LoggerLike;
+    disposer: Disposer;
     /** 收集器：`bootServer` 注入，把各资源注册的分类器按注册顺序收起来 */
     registerClassifyError: (classifier: ErrorClassifier) => void;
 }
@@ -31,6 +32,7 @@ export declare function createResourcesContext(params: ResourcesContextParams):
 export interface ConfigContextParams<R> {
     env: ConfigEnv;
     log: LoggerLike;
+    disposer: Disposer;
     resources: ResourcesView<R>;
 }
 export declare function createConfigContext<R>(params: ConfigContextParams<R>): ConfigContext<R>;
@@ -46,6 +48,7 @@ export declare function createServiceContext<R, C>(params: ServiceContextParams<
 export interface MiddlewareContextParams<C, S> {
     app: AppInstance;
     log: LoggerLike;
+    disposer: Disposer;
     services: Awaited<S>;
     holder: ConfigHolder<C>;
 }
@@ -54,6 +57,7 @@ export declare function createMiddlewareContext<C, S>(params: MiddlewareContextP
 export interface RouterContextParams<S> {
     app: AppInstance;
     log: LoggerLike;
+    disposer: Disposer;
     services: Awaited<S>;
 }
 export declare function createRouterContext<S>(params: RouterContextParams<S>): RouterContext<S>;

package/output/app/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../source/app/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../source/app/context.ts"],"names":[],"mappings":"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"}

package/output/app/context.js

@@ -31,10 +31,15 @@ export function readConfigKey(config, key) {
     return config?.[key];
 }
 export function createResourcesContext(params) {
-    return { env: params.env, log: params.log, registerClassifyError: params.registerClassifyError };
+    return {
+        env: params.env,
+        log: params.log,
+        disposer: params.disposer,
+        registerClassifyError: params.registerClassifyError,
+    };
 }
 export function createConfigContext(params) {
-    return { env: params.env, log: params.log, resources: params.resources };
+    return { env: params.env, log: params.log, disposer: params.disposer, resources: params.resources };
 }
 export function createServiceContext(params) {
     return {
@@ -50,6 +55,7 @@ export function createMiddlewareContext(params) {
     return {
         app: params.app,
         log: params.log,
+        disposer: params.disposer,
         services: params.services,
         get config() {
             return requireConfig(params.holder);
@@ -57,7 +63,7 @@ export function createMiddlewareContext(params) {
     };
 }
 export function createRouterContext(params) {
-    return { app: params.app, log: params.log, services: params.services };
+    return { app: params.app, log: params.log, disposer: params.disposer, services: params.services };
 }
 export function createShutdownContext(params) {
     return {

package/output/app/entries.d.ts

@@ -24,6 +24,8 @@ export declare function startServer<R, C, S>(server: Server<R, C, S>, options?:
  *
  * **红线**：全程**不得要求配置有效** —— 不跑 `config` 槽位、不要求 `DATABASE_URL` / `REDIS_URL`
  * 有效；`resources`（只构造不建连）/ `services` / 中间件注册 / 路由注册照常执行。
+ *
+ * 出 spec 路径**不关闭服务**，因此也不会 flush 任何阶段的 `disposer`。
  */
 export declare function generateOpenApi<R, C, S>(server: Server<R, C, S>): Promise<OpenApiDocument>;
 //# sourceMappingURL=entries.d.ts.map

package/output/app/entries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../source/app/entries.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAMpF;AAED,yCAAyC;AACzC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAMnF;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAavI;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAiBhG"}
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../source/app/entries.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAMpF;AAED,yCAAyC;AACzC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAMnF;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAavI;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAiBhG"}

package/output/app/entries.js

@@ -46,6 +46,8 @@ export async function startServer(server, options = {}) {
  *
  * **红线**：全程**不得要求配置有效** —— 不跑 `config` 槽位、不要求 `DATABASE_URL` / `REDIS_URL`
  * 有效；`resources`（只构造不建连）/ `services` / 中间件注册 / 路由注册照常执行。
+ *
+ * 出 spec 路径**不关闭服务**，因此也不会 flush 任何阶段的 `disposer`。
  */
 export async function generateOpenApi(server) {
     // 不加载 .env 文件、不读配置

package/output/app/lifecycle-logging.test.js

@@ -1,12 +1,14 @@
 import { describe, expect, it, vi } from 'vitest';
+import { Disposer } from '@taicode/common-base';
 import { defineServer, startServer } from './entries.js';
-import { buildDisposeOrder, initServiceUnits, LIFECYCLE_PHASE_DISPOSE, LIFECYCLE_PHASE_INIT, MIDDLEWARES_LOG_STAGE, middlewareUnitName, SERVICES_STAGE, serviceUnitName, } from './lifecycle.js';
+import { buildDisposeOrder, disposeStage, initServiceUnits, LIFECYCLE_PHASE_DISPOSE, LIFECYCLE_PHASE_INIT, MIDDLEWARES_LOG_STAGE, middlewareUnitName, RESOURCES_STAGE, SERVICES_STAGE, serviceUnitName, } from './lifecycle.js';
 import { createRecordingLogger } from './test-support.js';
 /**
  * 逐单元日志。
  *
  * - **注册期**：每个中间件注册后打一条 `debug`，带 `{ service, unit, stage: 'middlewares' }`；
  * - **init / dispose**：逐单元 `debug`（开始 / 完成），失败 `error`；带 `{ service, unit, stage, phase }`；
+ * - **阶段 flush**：`disposeStage` 每阶段一条 `debug`（`unit` = 阶段名）；
  * - 中间件名字：`unit.name ?? '<service>:middleware[<index>]'`；services 用对象键。
  *
  * 分两层验证：
@@ -91,6 +93,19 @@ describe('逐单元日志：init / dispose', () => {
         expect(middlewareUnitName('svc', {}, 3)).toBe('svc:middleware[3]');
         expect(middlewareUnitName('svc', { name: 'named' }, 1)).toBe('named');
     });
+    it('阶段 flush：`unit` / `stage` = 阶段名，`phase` = dispose', async () => {
+        const log = createRecordingLogger();
+        const disposer = new Disposer();
+        await disposeStage({ service: 'svc', log, stage: RESOURCES_STAGE, disposer });
+        const fields = log.entries.map((entry) => entry.obj);
+        expect(fields.length).toBeGreaterThan(0);
+        for (const field of fields) {
+            expect(field.service).toBe('svc');
+            expect(field.unit).toBe(RESOURCES_STAGE);
+            expect(field.stage).toBe(RESOURCES_STAGE);
+            expect(field.phase).toBe(LIFECYCLE_PHASE_DISPOSE);
+        }
+    });
 });
 // ── 真路径：`startServer` 走完整装配，捕获框架 logger 写入 ────────
 const captured = vi.hoisted(() => ({ lines: [] }));
@@ -148,8 +163,13 @@ describe('startServer 真路径：注册 / init / dispose 逐单元日志', () =
         // init / dispose：services 逐单元 debug（带 `phase`）
         expect(matchRecords(records, { unit: 'alpha', stage: SERVICES_STAGE, phase: LIFECYCLE_PHASE_INIT }).length).toBeGreaterThan(0);
         expect(matchRecords(records, { unit: 'alpha', stage: SERVICES_STAGE, phase: LIFECYCLE_PHASE_DISPOSE }).length).toBeGreaterThan(0);
-        // 中间件**不参与生命周期**：没有 middlewares 阶段的 init / dispose 日志
+        // 中间件**没有逐单元生命周期**：没有 middlewares 阶段的 init 日志；dispose 只有阶段 flush
         expect(matchRecords(records, { stage: MIDDLEWARES_LOG_STAGE, phase: LIFECYCLE_PHASE_INIT })).toHaveLength(0);
-        expect(matchRecords(records, { stage: MIDDLEWARES_LOG_STAGE, phase: LIFECYCLE_PHASE_DISPOSE })).toHaveLength(0);
+        const middlewareDispose = matchRecords(records, {
+            stage: MIDDLEWARES_LOG_STAGE,
+            phase: LIFECYCLE_PHASE_DISPOSE,
+        });
+        expect(middlewareDispose.length).toBeGreaterThan(0);
+        expect(middlewareDispose.every((record) => record.unit === MIDDLEWARES_LOG_STAGE)).toBe(true);
     });
 });

package/output/app/lifecycle.d.ts

@@ -1,15 +1,27 @@
+import type { Disposer } from '@taicode/common-base';
 import type { LoggerLike } from './types.js';
 /**
  * 生命周期序（N1 §4 / N2 §2.5）。
  *
- * **只有 `services` 参与生命周期**：
+ * **每个阶段一个 `Disposer`**（`ctx.disposer`，所有槽位都有）：在创建某个东西的地方当场
+ * `ctx.disposer.add(() => 释放它)` —— 创建与释放同处一地。
+ *
+ * 关闭时按阶段**逆序 flush**：`routers → middlewares → services → config → resources`
+ * （后创建的先销毁；Prisma / Redis 这类资源最后才断）。
+ *
+ * **`services` 额外有逐单元生命周期**：
  * - 单元之间**不得相互依赖**（`services` 的 ctx 没有 `services` 字段，编译期禁止）；
- * - 顺序语义只有一条：按**对象声明序** `init`、**逆序** `dispose`；
- * - `middlewares` 按数组序注册，**不参与生命周期**（要常驻资源就放 `services`）；
- * - `resources` 只是惰性包装（构造不建连），框架不替它们做生命周期。
+ * - `init` 按**对象声明序**，`dispose` **逆序**；
+ * - services 阶段内部**先 flush `ctx.disposer`**（构造期注册的清理），再逐单元 `dispose`。
+ *
+ * `middlewares` 按数组序注册；它只有 `disposer`，没有逐单元生命周期。
  */
 export declare const SERVICES_STAGE = "services";
-/** `middlewares` 的**注册期日志**阶段标签（中间件不参与生命周期，只用于注册日志） */
+export declare const CONFIG_STAGE = "config";
+export declare const MIDDLEWARES_STAGE = "middlewares";
+export declare const ROUTERS_STAGE = "routers";
+export declare const RESOURCES_STAGE = "resources";
+/** `middlewares` 的**注册期日志**阶段标签（与生命周期阶段同名） */
 export declare const MIDDLEWARES_LOG_STAGE = "middlewares";
 /** 生命周期相位（逐单元日志字段 `phase`） */
 export declare const LIFECYCLE_PHASE_INIT = "init";
@@ -27,7 +39,7 @@ export interface LifecycleLogContext {
     /** 记录型 logger（`ctx.log`）；缺省 = 不打日志 */
     log?: LoggerLike;
 }
-/** 逐单元日志字段（全拼）：`unit` = 有效名字，`stage` = `services` */
+/** 逐单元日志字段（全拼）：`unit` = 有效名字（阶段 flush 时为阶段名），`stage` = 阶段名 */
 export interface LifecycleUnitLogFields {
     service: string;
     unit: string;
@@ -67,4 +79,18 @@ export declare function buildDisposeOrder(params: DisposeServiceUnitsParams): Ar
  * 此处仅保证单步不阻断后续。
  */
 export declare function disposeServices(params: DisposeServiceUnitsParams): Promise<void>;
+/** `disposeStage` 入参（参数签名内联对象类型已按 lint 规则外提） */
+export interface DisposeStageParams extends LifecycleLogContext {
+    /** 阶段名（`routers` / `middlewares` / `services` / `config` / `resources`） */
+    stage: string;
+    /** 该阶段的 `Disposer`（构造期注册的清理函数，**逆注册序**执行） */
+    disposer: Disposer;
+}
+/**
+ * 关闭步：flush 某个阶段的 `disposer`。
+ *
+ * 单元名 = 阶段名（一个阶段一个 `Disposer`，不逐注册项打日志）；`phase` 固定 `dispose`。
+ * 单个清理函数失败由 `Disposer` 自己捕获记录，不影响同阶段其它函数。
+ */
+export declare function disposeStage(params: DisposeStageParams): Promise<void>;
 //# sourceMappingURL=lifecycle.d.ts.map

package/output/app/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../source/app/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;;GAQG;AAEH,eAAO,MAAM,cAAc,aAAa,CAAA;AACxC,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,gBAAgB,CAAA;AAElD,8BAA8B;AAC9B,eAAO,MAAM,oBAAoB,SAAS,CAAA;AAC1C,eAAO,MAAM,uBAAuB,YAAY,CAAA;AAChD,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,GAAG,OAAO,uBAAuB,CAAA;AAEzF;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,GAAG,CAAC,EAAE,UAAU,CAAA;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,cAAc,CAAA;CACtB;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxF;AAED,oDAAoD;AACpD,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAmCD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpF;AAED,6EAA6E;AAC7E,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,yBAAyB,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAMtG;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtF"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../source/app/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,cAAc,aAAa,CAAA;AACxC,eAAO,MAAM,YAAY,WAAW,CAAA;AACpC,eAAO,MAAM,iBAAiB,gBAAgB,CAAA;AAC9C,eAAO,MAAM,aAAa,YAAY,CAAA;AACtC,eAAO,MAAM,eAAe,cAAc,CAAA;AAC1C,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB,gBAAoB,CAAA;AAEtD,8BAA8B;AAC9B,eAAO,MAAM,oBAAoB,SAAS,CAAA;AAC1C,eAAO,MAAM,uBAAuB,YAAY,CAAA;AAChD,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,GAAG,OAAO,uBAAuB,CAAA;AAEzF;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,GAAG,CAAC,EAAE,UAAU,CAAA;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,cAAc,CAAA;CACtB;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxF;AAED,oDAAoD;AACpD,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAmCD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpF;AAED,6EAA6E;AAC7E,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,yBAAyB,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAMtG;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtF;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU5E"}

package/output/app/lifecycle.js

@@ -1,15 +1,26 @@
 /**
  * 生命周期序（N1 §4 / N2 §2.5）。
  *
- * **只有 `services` 参与生命周期**：
+ * **每个阶段一个 `Disposer`**（`ctx.disposer`，所有槽位都有）：在创建某个东西的地方当场
+ * `ctx.disposer.add(() => 释放它)` —— 创建与释放同处一地。
+ *
+ * 关闭时按阶段**逆序 flush**：`routers → middlewares → services → config → resources`
+ * （后创建的先销毁；Prisma / Redis 这类资源最后才断）。
+ *
+ * **`services` 额外有逐单元生命周期**：
  * - 单元之间**不得相互依赖**（`services` 的 ctx 没有 `services` 字段，编译期禁止）；
- * - 顺序语义只有一条：按**对象声明序** `init`、**逆序** `dispose`；
- * - `middlewares` 按数组序注册，**不参与生命周期**（要常驻资源就放 `services`）；
- * - `resources` 只是惰性包装（构造不建连），框架不替它们做生命周期。
+ * - `init` 按**对象声明序**，`dispose` **逆序**；
+ * - services 阶段内部**先 flush `ctx.disposer`**（构造期注册的清理），再逐单元 `dispose`。
+ *
+ * `middlewares` 按数组序注册；它只有 `disposer`，没有逐单元生命周期。
  */
 export const SERVICES_STAGE = 'services';
-/** `middlewares` 的**注册期日志**阶段标签（中间件不参与生命周期，只用于注册日志） */
-export const MIDDLEWARES_LOG_STAGE = 'middlewares';
+export const CONFIG_STAGE = 'config';
+export const MIDDLEWARES_STAGE = 'middlewares';
+export const ROUTERS_STAGE = 'routers';
+export const RESOURCES_STAGE = 'resources';
+/** `middlewares` 的**注册期日志**阶段标签（与生命周期阶段同名） */
+export const MIDDLEWARES_LOG_STAGE = MIDDLEWARES_STAGE;
 /** 生命周期相位（逐单元日志字段 `phase`） */
 export const LIFECYCLE_PHASE_INIT = 'init';
 export const LIFECYCLE_PHASE_DISPOSE = 'dispose';
@@ -97,3 +108,20 @@ export async function disposeServices(params) {
         }
     }
 }
+/**
+ * 关闭步：flush 某个阶段的 `disposer`。
+ *
+ * 单元名 = 阶段名（一个阶段一个 `Disposer`，不逐注册项打日志）；`phase` 固定 `dispose`。
+ * 单个清理函数失败由 `Disposer` 自己捕获记录，不影响同阶段其它函数。
+ */
+export async function disposeStage(params) {
+    const fields = {
+        service: params.service ?? '',
+        unit: params.stage,
+        stage: params.stage,
+        phase: LIFECYCLE_PHASE_DISPOSE,
+    };
+    params.log?.debug(fields, `[lifecycle] ${LIFECYCLE_PHASE_DISPOSE} "${params.stage}" start`);
+    await params.disposer.dispose();
+    params.log?.debug(fields, `[lifecycle] ${LIFECYCLE_PHASE_DISPOSE} "${params.stage}" done`);
+}

package/output/app/lifecycle.test.js

@@ -4,10 +4,11 @@ import { buildDisposeOrder, initServiceUnits, serviceUnitName } from './lifecycl
 /**
  * 生命周期（N1 §4）。
  *
- * - **只有 `services` 参与**：按**对象声明序** `init` / **逆序** `dispose`；
+ * - **每个阶段一个 `Disposer`**（`ctx.disposer`）：创建处注册释放，关闭时按阶段逆序 flush；
+ * - **`services` 额外有逐单元生命周期**：按**对象声明序** `init` / **逆序** `dispose`；
+ * - services 阶段内部：先 flush 自己的 `disposer`，再逐单元 `dispose`；
  * - **没有 `dependsOn`**（`services` 的 ctx 没有 `services` 字段，编译期禁止互依）；
- * - 单元名 = **对象键**；
- * - `middlewares` 按数组序注册，**不参与生命周期**。
+ * - 单元名 = **对象键**。
  */
 describe('init / dispose 顺序：声明序 / 逆序（N1 §4 / §5）', () => {
     it('init：services 按对象声明序', async () => {

package/output/app/middleware-order.test.js

@@ -10,20 +10,21 @@ import { defaultMiddlewares } from './middleware/index.js';
 const fakeMiddlewareContext = {
     app: {},
     log: { debug: () => { }, info: () => { }, warn: () => { }, error: () => { } },
+    disposer: { add: () => { }, dispose: async () => { } },
     services: {},
     config: {},
 };
 describe('ctx 可见性（N1 §2）', () => {
-    it('MiddlewareContext 有 app / log / services / config；没有 resources / env / disposer', () => {
+    it('MiddlewareContext 有 app / log / disposer / services / config；没有 resources / env', () => {
         expectTypeOf().toHaveProperty('app');
         expectTypeOf().toHaveProperty('services');
         expectTypeOf().toHaveProperty('config');
+        // `disposer` 是所有槽位的标配（不是 services 专属）
+        expectTypeOf().toHaveProperty('disposer');
         // @ts-expect-error 中间件看不到 resources（禁直连数据层）
         void 0..resources;
         // @ts-expect-error 中间件看不到 env
         void 0..env;
-        // @ts-expect-error 中间件看不到 disposer（disposer 只属 services）
-        void 0..disposer;
     });
 });
 describe('默认预设', () => {

package/output/app/redis.d.ts

@@ -4,17 +4,21 @@ import type { LoggerLike, RedisHandle } from './types.js';
 /**
  * 引导期 Redis / cache helper（N2 §2.13）。
  *
- * 在 `resources(ctx)` 槽位里按需调用（框架自己**不**创建 Redis）：
+ * 在 `resources(ctx)` 槽位里按需调用（框架自己**不**创建 Redis）；释放**在创建处**登记：
  *
  * ```ts
  * resources: (ctx) => {
  *   const redis = createRedis(ctx.env, ctx.log)          // 无 REDIS_URL → undefined
+ *   if (redis) {
+ *     ctx.disposer.add(() => redis.dispose())            // 关闭时 resources 阶段最后 flush
+ *   }
  *   return { redis, cache: createCache({ env: ctx.env, prefix: 'account', redis }) }
  * }
  * ```
  *
  * `REDIS_URL` 由 helper 直接读 `env`（固定约定），**不**取自 `config`；`redis` / `cache` 一律是
  * **惰性包装**：构造时不建连、不 ping，首次真正使用才建连 —— 「出 spec 不连库/Redis」结构性成立。
+ * 释放永远走调用方在 `ctx.disposer` 里的登记，框架不替资源持有句柄。
  */
 /** 一级/二级缓存默认 TTL（秒），与 `RedisCache` 默认一致 */
 export declare const DEFAULT_REDIS_CACHE_TTL_SECONDS = 300;

package/output/app/redis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../source/app/redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEzD;;;;;;;;;;;;;;GAcG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAmBrF;AAED,uBAAuB;AACvB,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,SAAS,CAAA;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,GAAG,CAAC,EAAE,UAAU,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAYhE"}
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../source/app/redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEzD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAmBrF;AAED,uBAAuB;AACvB,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,SAAS,CAAA;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,GAAG,CAAC,EAAE,UAAU,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAYhE"}

package/output/app/redis.js

@@ -2,17 +2,21 @@ import { createRedisClient, RedisCache } from '../redis-cache/index.js';
 /**
  * 引导期 Redis / cache helper（N2 §2.13）。
  *
- * 在 `resources(ctx)` 槽位里按需调用（框架自己**不**创建 Redis）：
+ * 在 `resources(ctx)` 槽位里按需调用（框架自己**不**创建 Redis）；释放**在创建处**登记：
  *
  * ```ts
  * resources: (ctx) => {
  *   const redis = createRedis(ctx.env, ctx.log)          // 无 REDIS_URL → undefined
+ *   if (redis) {
+ *     ctx.disposer.add(() => redis.dispose())            // 关闭时 resources 阶段最后 flush
+ *   }
  *   return { redis, cache: createCache({ env: ctx.env, prefix: 'account', redis }) }
  * }
  * ```
  *
  * `REDIS_URL` 由 helper 直接读 `env`（固定约定），**不**取自 `config`；`redis` / `cache` 一律是
  * **惰性包装**：构造时不建连、不 ping，首次真正使用才建连 —— 「出 spec 不连库/Redis」结构性成立。
+ * 释放永远走调用方在 `ctx.disposer` 里的登记，框架不替资源持有句柄。
  */
 /** 一级/二级缓存默认 TTL（秒），与 `RedisCache` 默认一致 */
 export const DEFAULT_REDIS_CACHE_TTL_SECONDS = 300;

package/output/app/resources.test.js

@@ -16,7 +16,7 @@ const assertLiveKeysRemovesFalse = () => {
 };
 void assertLiveKeysRemovesFalse;
 describe('resources 槽位（N1 §2 / N2 §2.3）', () => {
-    it('① 入参为 env + log + registerClassifyError，且资源嵌套在 ctx.resources 下（config / services 都能用）', async () => {
+    it('① 入参为 env + log + disposer + registerClassifyError，且资源嵌套在 ctx.resources 下（config / services 都能用）', async () => {
         let captured;
         const observed = {};
         const server = defineServer({
@@ -43,9 +43,11 @@ describe('resources 槽位（N1 §2 / N2 §2.3）', () => {
         });
         const app = await startServer(server, { listen: false });
         try {
-            expect(Object.keys(captured ?? {}).sort()).toEqual(['env', 'log', 'registerClassifyError']);
+            // 槽位 ctx：env + log + disposer（+ 专属的 registerClassifyError）
+            expect(Object.keys(captured ?? {}).sort()).toEqual(['disposer', 'env', 'log', 'registerClassifyError']);
             expect(captured?.env.ENV).toBeTypeOf('string');
             expect(typeof captured?.log.info).toBe('function');
+            expect(typeof captured?.disposer.add).toBe('function');
             // resources 槽位专属能力：每个资源注册自己的错误分类器（函数）
             expect(typeof captured?.registerClassifyError).toBe('function');
             expect(observed.inConfig).toBe('rows:select 1');
@@ -143,38 +145,59 @@ describe('resources 槽位（N1 §2 / N2 §2.3）', () => {
             await app.close();
         }
     });
-    it('⑤ 框架不管资源生命周期：资源上的 dispose 不被调用（释放要放 services）', async () => {
+    it('⑤ resources 的 disposer 在 services 阶段**之后**执行；阶段内按逆注册序；资源对象自带的 dispose 不被调用', async () => {
         const calls = [];
         const server = defineServer({
             app: { service: 'resources-lifecycle', title: 'Resources Lifecycle', version: '1.0.0' },
-            resources: () => ({
-                database: {
+            resources: (ctx) => {
+                // 资源对象自带的 `dispose` 不参与生命周期：释放只认 `ctx.disposer.add(...)`
+                const database = {
                     dispose: () => {
-                        calls.push('dispose:resource');
+                        calls.push('dispose:resource-object');
                     },
-                },
-            }),
+                };
+                ctx.disposer.add(() => {
+                    calls.push('dispose:resource-a');
+                });
+                ctx.disposer.add(() => {
+                    calls.push('dispose:resource-b');
+                });
+                return { database };
+            },
             config: () => ({}),
-            services: () => ({
-                databaseClient: {
-                    dispose: () => {
-                        calls.push('dispose:service');
+            services: (ctx) => {
+                ctx.disposer.add(() => {
+                    calls.push('dispose:services-disposer');
+                });
+                return {
+                    databaseClient: {
+                        dispose: () => {
+                            calls.push('dispose:service-unit');
+                        },
                     },
-                },
-            }),
+                };
+            },
             middlewares: () => [],
             routers: () => undefined,
         });
         const app = await startServer(server, { listen: false });
         await app.close();
-        expect(calls).toEqual(['dispose:service']);
+        expect(calls).toEqual([
+            'dispose:services-disposer',
+            'dispose:service-unit',
+            'dispose:resource-b',
+            'dispose:resource-a',
+        ]);
     });
-    it('⑥ 出 spec 路径同样跑 resources（只构造，不建连）', async () => {
-        let calls = 0;
+    it('⑥ 出 spec 路径同样跑 resources（只构造，不建连），但不 flush 任何 disposer', async () => {
+        const calls = [];
         const server = defineServer({
             app: { service: 'resources-openapi', title: 'Resources OpenApi', version: '1.0.0' },
-            resources: () => {
-                calls += 1;
+            resources: (ctx) => {
+                calls.push('resources');
+                ctx.disposer.add(() => {
+                    calls.push('dispose:resources');
+                });
                 return {};
             },
             config: () => ({}),
@@ -183,7 +206,7 @@ describe('resources 槽位（N1 §2 / N2 §2.3）', () => {
             routers: () => undefined,
         });
         await generateOpenApi(server);
-        expect(calls).toBe(1);
+        expect(calls).toEqual(['resources']);
     });
 });
 /** `ResourcesView` 自证：`Awaited<>` 归一（同步 / 异步两写法等价） */

package/output/app/shutdown.d.ts

@@ -1,14 +1,19 @@
 /**
  * 固定关闭步（N1 §5）——**顺序写死在数组里**。
  *
- * 新口径下框架不再持有 Redis / 数据库 / 外链客户端（这些都在 `resources` 里，由各仓自行构造，
- * 需要释放时放 `services` 单元）；配置失效通道已删除，故没有 `unsubscribeConfig` 步。
+ * `disposer` 是所有槽位 ctx 的标配：每个阶段一个 `Disposer`，在**创建处**注册释放。
+ * 关闭时按阶段**逆序 flush**：`routers → middlewares → services → config → resources`
+ * （后创建的先销毁；Prisma / Redis 这类资源**最后**才断）。
  *
- * 固定两步：`stopProducers`（`ctx.disposer` 注册的清理）→ `disposeServices`（services 逆序）。
+ * `services` 阶段内部保持既有语义：先 flush 自己的 `disposer`（原 `stopProducers`），
+ * 再 `disposeServices`（单元**逆序** `dispose`）。配置失效通道已删除，故没有 `unsubscribeConfig` 步。
+ *
+ * 固定六步：`flushRouters` → `flushMiddlewares` → `flushServices` → `disposeServices`
+ * → `flushConfig` → `flushResources`。
  *
  * 每步失败记日志、不阻断后续，最后聚合上报。
  */
-export declare const SHUTDOWN_ORDER: readonly ["stopProducers", "disposeServices"];
+export declare const SHUTDOWN_ORDER: readonly ["flushRouters", "flushMiddlewares", "flushServices", "disposeServices", "flushConfig", "flushResources"];
 export type ShutdownStepName = (typeof SHUTDOWN_ORDER)[number];
 export type ShutdownHandles = Record<ShutdownStepName, () => void | Promise<void>>;
 export interface ShutdownLogger {

package/output/app/shutdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../source/app/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,+CAAgD,CAAA;AAE3E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5C;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9F"}
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../source/app/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,oHAOjB,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5C;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9F"}

package/output/app/shutdown.js

@@ -1,14 +1,26 @@
 /**
  * 固定关闭步（N1 §5）——**顺序写死在数组里**。
  *
- * 新口径下框架不再持有 Redis / 数据库 / 外链客户端（这些都在 `resources` 里，由各仓自行构造，
- * 需要释放时放 `services` 单元）；配置失效通道已删除，故没有 `unsubscribeConfig` 步。
+ * `disposer` 是所有槽位 ctx 的标配：每个阶段一个 `Disposer`，在**创建处**注册释放。
+ * 关闭时按阶段**逆序 flush**：`routers → middlewares → services → config → resources`
+ * （后创建的先销毁；Prisma / Redis 这类资源**最后**才断）。
  *
- * 固定两步：`stopProducers`（`ctx.disposer` 注册的清理）→ `disposeServices`（services 逆序）。
+ * `services` 阶段内部保持既有语义：先 flush 自己的 `disposer`（原 `stopProducers`），
+ * 再 `disposeServices`（单元**逆序** `dispose`）。配置失效通道已删除，故没有 `unsubscribeConfig` 步。
+ *
+ * 固定六步：`flushRouters` → `flushMiddlewares` → `flushServices` → `disposeServices`
+ * → `flushConfig` → `flushResources`。
  *
  * 每步失败记日志、不阻断后续，最后聚合上报。
  */
-export const SHUTDOWN_ORDER = ['stopProducers', 'disposeServices'];
+export const SHUTDOWN_ORDER = [
+    'flushRouters',
+    'flushMiddlewares',
+    'flushServices',
+    'disposeServices',
+    'flushConfig',
+    'flushResources',
+];
 /**
  * 顺序执行关闭步骤；单步抛错记录后**继续**后续步骤，最后聚合上报
  * （避免「一步报错导致后面资源没关」）。

package/output/app/shutdown.test.js

@@ -13,13 +13,24 @@ function createRecordingHandles(record, throwOn) {
         }
     };
     return {
-        stopProducers: step('stopProducers'),
+        flushRouters: step('flushRouters'),
+        flushMiddlewares: step('flushMiddlewares'),
+        flushServices: step('flushServices'),
         disposeServices: step('disposeServices'),
+        flushConfig: step('flushConfig'),
+        flushResources: step('flushResources'),
     };
 }
 describe('SHUTDOWN_ORDER', () => {
-    it('固定两步且顺序不可变', () => {
-        expect(SHUTDOWN_ORDER).toEqual(['stopProducers', 'disposeServices']);
+    it('固定六步且顺序不可变：阶段逆序 flush，services 内部先 flush 再逐单元 dispose', () => {
+        expect(SHUTDOWN_ORDER).toEqual([
+            'flushRouters',
+            'flushMiddlewares',
+            'flushServices',
+            'disposeServices',
+            'flushConfig',
+            'flushResources',
+        ]);
     });
 });
 describe('runShutdown', () => {
@@ -32,7 +43,7 @@ describe('runShutdown', () => {
     it('单步抛错不阻断后续，并聚合上报', async () => {
         const record = [];
         const { entries, log } = createShutdownLog();
-        await runShutdown(createRecordingHandles(record, 'stopProducers'), log);
+        await runShutdown(createRecordingHandles(record, 'flushRouters'), log);
         expect(record).toEqual([...SHUTDOWN_ORDER]);
         const aggregate = entries.find((entry) => entry.msg === '[shutdown] completed with errors');
         expect(aggregate).toBeDefined();
@@ -42,15 +53,25 @@ describe('runShutdown', () => {
     });
 });
 describe('关闭流程集成', () => {
-    it('默认两步按序执行：disposer → services 逆序', async () => {
+    it('各阶段 disposer 按阶段逆序执行：routers → middlewares → services → config → resources', async () => {
         const calls = [];
         const server = defineServer({
-            app: { service: 'shutdown-integration', title: 'Shutdown Integration', version: '1.0.0' },
-            resources: () => ({ database: { dispose: () => calls.push('disposeResource') } }),
-            config: () => ({}),
+            app: { service: 'shutdown-stages', title: 'Shutdown Stages', version: '1.0.0' },
+            resources: (ctx) => {
+                ctx.disposer.add(() => {
+                    calls.push('flushResources');
+                });
+                return {};
+            },
+            config: (ctx) => {
+                ctx.disposer.add(() => {
+                    calls.push('flushConfig');
+                });
+                return {};
+            },
             services: (ctx) => {
                 ctx.disposer.add(() => {
-                    calls.push('stopProducers');
+                    calls.push('flushServices');
                 });
                 return {
                     a: {
@@ -58,26 +79,111 @@ describe('关闭流程集成', () => {
                             calls.push('disposeServiceA');
                         },
                     },
-                    b: {
-                        dispose: () => {
-                            calls.push('disposeServiceB');
-                        },
-                    },
                 };
             },
+            middlewares: (ctx) => {
+                ctx.disposer.add(() => {
+                    calls.push('flushMiddlewares');
+                });
+                return [];
+            },
+            routers: (ctx) => {
+                ctx.disposer.add(() => {
+                    calls.push('flushRouters');
+                });
+            },
+        });
+        const app = await startServer(server, { listen: false });
+        await app.close();
+        expect(calls).toEqual([
+            'flushRouters',
+            'flushMiddlewares',
+            'flushServices',
+            'disposeServiceA',
+            'flushConfig',
+            'flushResources',
+        ]);
+    });
+    it('阶段内多个 disposer 按**逆注册序**（LIFO）执行', async () => {
+        const calls = [];
+        const server = defineServer({
+            app: { service: 'shutdown-lifo', title: 'Shutdown LIFO', version: '1.0.0' },
+            resources: (ctx) => {
+                // 先建 A，再建 B（B 可能依赖 A）→ 关闭时先 B 后 A
+                ctx.disposer.add(() => {
+                    calls.push('disposeA');
+                });
+                ctx.disposer.add(() => {
+                    calls.push('disposeB');
+                });
+                return {};
+            },
+            config: () => ({}),
+            services: () => ({}),
             middlewares: () => [],
             routers: () => undefined,
         });
         const app = await startServer(server, { listen: false });
         await app.close();
-        // 资源不在生命周期内（框架只管 services）
-        expect(calls).toEqual(['stopProducers', 'disposeServiceB', 'disposeServiceA']);
+        expect(calls).toEqual(['disposeB', 'disposeA']);
+    });
+    it('某个 disposer 抛错不影响同阶段其它 disposer（且 `close()` 不抛）', async () => {
+        const calls = [];
+        const server = defineServer({
+            app: { service: 'shutdown-disposer-error', title: 'Shutdown Disposer Error', version: '1.0.0' },
+            resources: (ctx) => {
+                ctx.disposer.add(() => {
+                    calls.push('disposeA');
+                });
+                ctx.disposer.add(() => {
+                    calls.push('disposeB:throw');
+                    throw new Error('disposer boom');
+                });
+                ctx.disposer.add(() => {
+                    calls.push('disposeC');
+                });
+                return {};
+            },
+            config: () => ({}),
+            services: () => ({}),
+            middlewares: () => [],
+            routers: () => undefined,
+        });
+        const app = await startServer(server, { listen: false });
+        await expect(app.close()).resolves.toBeUndefined();
+        // LIFO：C → B（抛错）→ A；B 的错误不阻断 A
+        expect(calls).toEqual(['disposeC', 'disposeB:throw', 'disposeA']);
+    });
+    it('未注册任何 disposer 时无操作：关闭照常完成', async () => {
+        const calls = [];
+        const server = defineServer({
+            app: { service: 'shutdown-empty', title: 'Shutdown Empty', version: '1.0.0' },
+            resources: () => ({}),
+            config: () => ({}),
+            services: () => ({
+                a: {
+                    dispose: () => {
+                        calls.push('disposeServiceA');
+                    },
+                },
+            }),
+            middlewares: () => [],
+            routers: () => undefined,
+        });
+        const app = await startServer(server, { listen: false });
+        await expect(app.close()).resolves.toBeUndefined();
+        expect(calls).toEqual(['disposeServiceA']);
     });
     it('StartServerOptions.shutdown 整体覆盖默认关闭流程', async () => {
         const calls = [];
         const server = defineServer({
             app: { service: 'shutdown-override', title: 'Shutdown Override', version: '1.0.0' },
-            resources: () => ({}),
+            resources: (ctx) => {
+                ctx.disposer.add(() => {
+                    calls.push('flushResources');
+                });
+                return {};
+            },
             config: () => ({}),
             services: () => ({
                 a: {
@@ -98,6 +204,7 @@ describe('关闭流程集成', () => {
             },
         });
         await app.close();
+        // 整体覆盖：默认六步（含各阶段 flush）都不执行
         expect(calls).toEqual(['custom']);
     });
 });

package/output/app/types.d.ts

@@ -21,8 +21,16 @@ import type { SystemError } from './errors.js';
  * 槽位只能引用**排在它前面**的产物（向下引用是编译错误）；`env` 只属引导期
  * （`resources` / `config` 可见，运行期三层一律看不到）。
  *
+ * **`disposer` 是每个槽位 ctx 的标配**（不是某个槽位专属）：在**创建某个东西的地方**当场
+ * `ctx.disposer.add(() => 释放它)`，创建与释放同处一地；`disposer` 是**出口**（不产出任何依赖），
+ * 因此不会造成循环，也不削弱「只给该阶段该看的字段」的约束。
+ *
+ * 生命周期：每个阶段一个独立的 `Disposer` 实例；关闭时**按阶段逆序 flush**
+ * `routers → middlewares → services → config → resources`（services 阶段内部：先 flush
+ * disposer，再逐单元逆序 `dispose`）。详见 `lifecycle.ts` / `shutdown.ts`。
+ *
  * 类型安全机制（N2 §1）：
- * - **M1 分阶段 ctx**：每个工厂只拿到「该阶段该看的字段」；
+ * - **M1 分阶段 ctx**：每个工厂只拿到「该阶段该看的字段」（**外加每个阶段都有的 `disposer`**）；
  * - **M2 `Awaited<>` 归一**：工厂签名写 `(ctx) => R`（不是 `R | Promise<R>`），下游一律
  *   `Awaited<R>` / `Awaited<C>` / `Awaited<S>`；
  * - **M3 资源嵌套**：资源包挂在 `ctx.resources` 上（不再摊平到 ctx，键冲突从根上消失）；
@@ -91,13 +99,21 @@ export type ResourcesView<R> = Live<Awaited<R>>;
  */
 export type ErrorClassifier = (error: unknown) => SystemError | null;
 /**
- * `resources(ctx)` 的入参：**只有 `env` + `log`**（外加槽位专属的注册能力）。
+ * `resources(ctx)` 的入参：**`env` + `log` + `disposer`**（外加槽位专属的注册能力）。
  *
  * 结构上排除 `config` / `services` / `app` → 「资源依赖配置」这类循环**编译期写不出来**。
+ * `disposer` 是**出口**（只能注册释放函数，不产出依赖），因此不构成新的循环面：
+ * 资源在构造处当场 `ctx.disposer.add(() => 释放它)`，关闭时框架最后 flush。
  */
 export interface ResourcesContext {
     readonly env: ConfigEnv;
     readonly log: LoggerLike;
+    /**
+     * 本阶段的释放器：**在创建资源的地方当场注册释放**。
+     *
+     * 关闭序中 `resources` 阶段**最后** flush（所有其它阶段都还活着）。
+     */
+    readonly disposer: Disposer;
     /**
      * **每个资源注册自己的错误分类器**（响应层用）。
      *
@@ -109,13 +125,15 @@ export interface ResourcesContext {
 }
 export type ResourcesFactory<R> = (ctx: ResourcesContext) => R;
 /**
- * `config(ctx)` 的入参：`env` + `log` + 资源视图。
+ * `config(ctx)` 的入参：`env` + `log` + `disposer` + 资源视图。
  *
  * **没有** `services`（此时尚未构造）/ `app`（此时尚未装配）。
  */
 export interface ConfigContext<R> {
     readonly env: ConfigEnv;
     readonly log: LoggerLike;
+    /** 本阶段的释放器（关闭时在 services 之后、resources 之前 flush） */
+    readonly disposer: Disposer;
     readonly resources: ResourcesView<R>;
 }
 export type ConfigFactory<R, C> = (ctx: ConfigContext<R>) => C;
@@ -136,6 +154,7 @@ export interface ServiceUnit {
  */
 export interface ServiceContext<R, C> {
     readonly log: LoggerLike;
+    /** 本阶段的释放器（关闭时**先** flush 它，再逐单元逆序 `dispose`） */
     readonly disposer: Disposer;
     readonly resources: ResourcesView<R>;
     readonly config: Awaited<C>;
@@ -151,25 +170,29 @@ export interface MiddlewareUnit {
     register(app: AppInstance): void | Promise<void>;
 }
 /**
- * `middlewares(ctx)` 的入参：`app` + `log` + `services` + `config`。
+ * `middlewares(ctx)` 的入参：`app` + `log` + `disposer` + `services` + `config`。
  *
  * ❗**故意没有 `resources` / `env`** —— 中间件要访问数据层必须穿过 service。
  */
 export interface MiddlewareContext<C, S> {
     readonly app: AppInstance;
     readonly log: LoggerLike;
+    /** 本阶段的释放器（关闭时最早 flush：在 services / config / resources 之前） */
+    readonly disposer: Disposer;
     readonly services: Awaited<S>;
     readonly config: Awaited<C>;
 }
 export type MiddlewaresFactory<C, S> = (ctx: MiddlewareContext<C, S>) => MiddlewareUnit[];
 /**
- * `routers(ctx)` 的入参：`app` + `log` + `services`。
+ * `routers(ctx)` 的入参：`app` + `log` + `disposer` + `services`。
  *
  * ❗**故意没有 `resources` / `env` / `config`** —— 路由**只能穿过 service**，绕不过层直连数据层。
  */
 export interface RouterContext<S> {
     readonly app: AppInstance;
     readonly log: LoggerLike;
+    /** 本阶段的释放器（关闭时**最先** flush） */
+    readonly disposer: Disposer;
     readonly services: Awaited<S>;
 }
 export type RoutersFactory<S> = (ctx: RouterContext<S>) => void | Promise<void>;

package/output/app/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../source/app/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../source/app/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taicode/common-server",
-  "version": "4.0.0-beta.2",
+  "version": "4.0.0-beta.3",
   "author": "Alain",
   "license": "ISC",
   "description": "",
@@ -35,7 +35,7 @@
   "peerDependencies": {
     "fastify": "^5.5.0",
     "redis": "^5.11.0",
-    "@taicode/common-base": "^4.0.0-beta.2"
+    "@taicode/common-base": "^4.0.0-beta.3"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.3",
@@ -49,7 +49,7 @@
     "redis": "^5.11.0",
     "typescript-eslint": "^8.56.1",
     "vitest": "^3.2.4",
-    "@taicode/common-base": "^4.0.0-beta.2"
+    "@taicode/common-base": "^4.0.0-beta.3"
   },
   "scripts": {
     "test": "vitest run",