Promise finally 蓋掉原本錯誤？保留工作與清理失敗的原因

2026-11-11

前端

JavaScript

/

前端開發

/

問題解決

/

教學

本文目錄

writeFile().finally(closeFile) 裡，寫入和關閉都失敗時，呼叫端會收到哪個錯誤？**.finally() 回傳的新 Promise 會以清理失敗的原因拒絕。**原本的工作 Promise 仍保有自己的拒絕原因，但只捕捉整條鏈時，容易漏掉它。

MDN與 ECMAScript 演算法說明：finally callback 成功完成時，原結果往後傳；callback 拋錯或回傳 rejected Promise，才會用新的原因拒絕。這裡用工作與清理各一個函式，明確選擇雙重失敗的處理政策。

先決定雙重失敗時要給呼叫端什麼#

工作	清理	本文 wrapper 的結果
成功	成功	原工作值
失敗	成功	原工作錯誤
成功	失敗	清理錯誤
失敗	失敗	`AggregateError`，依序放工作與清理錯誤

這適合清理必須完成、而呼叫端能查看多個原因的工作。如果清理只是 best effort，則可在清理內捕捉並記錄錯誤，讓原工作結果保持不變；記錄管道本身也須有失敗政策。既有呼叫端若只按單一錯誤類型分支，採用 aggregate 前要一起調整。

下面的 withCleanup() 接收工作函式，因此同步拋錯和非同步拒絕都會進入同一條流程。用獨立布林值記錄工作失敗，才能正確處理 Promise.reject(undefined)。

一份可直接跑的錯誤保留範例#

存成 cleanup.mjs，執行 node cleanup.mjs。範例使用假工作與假清理，沒有操作檔案或連線：

1
import assert from 'node:assert/strict';
2

3
async function withCleanup(work, cleanup) {
4
  let value;
5
  let workFailed = false;
6
  let workError;
7
  try {
8
    value = await work();
9
  } catch (error) {
10
    workFailed = true;
11
    workError = error;
12
  }
13
  try {
14
    await cleanup();
15
  } catch (cleanupError) {
16
    if (workFailed) {
17
      throw new AggregateError([workError, cleanupError], '工作與清理都失敗');
18
    }
19
    throw cleanupError;
20
  }
21
  if (workFailed) throw workError;
22
  return value;
23
}
24

25
const writeError = new Error('write failed');
26
const closeError = new Error('close failed');
27
const ok = () => 42;
28
const failWrite = () => Promise.reject(writeError);
29
const failClose = () => Promise.reject(closeError);
30

31
await assert.rejects(failWrite().finally(failClose), e => e === closeError);
32
assert.equal(await Promise.resolve(42).finally(() => 99), 42);
33
assert.equal(await withCleanup(ok, () => 99), 42);
34
await assert.rejects(withCleanup(failWrite, () => {}), e => e === writeError);
35
await assert.rejects(withCleanup(ok, failClose), e => e === closeError);
36
await assert.rejects(withCleanup(failWrite, failClose), e => {
37
  assert.ok(e instanceof AggregateError);
38
  assert.deepEqual(e.errors, [writeError, closeError]);
39
  return true;
40
});
41
await assert.rejects(withCleanup(() => Promise.reject(undefined), failClose), e => {
42
  assert.deepEqual(e.errors, [undefined, closeError]);
43
  return true;
44
});
45
await assert.rejects(withCleanup(() => { throw writeError; }, () => {}),
46
  e => e === writeError);
47
console.log('finally 與清理政策檢查通過');