async函数中return普通对象会自动包装为resolved Promise，可统一用{success, data/error}结构封装异步结果，避免throw以消除调用方try/catch需求。
在 JavaScript 的 async 函数中，直接 return 一个值（比如对象、字符串或 Promise）会自动被包装成一个已解决（resolved）的 Promise。若你想返回**自定义结构的异步结果**（例如带状态、数据、错误信息的对象），核心思路是：**用普通对象封装结果，但确保整个函数仍符合 async/await 语义——即最终返回 Promise，并让调用方能自然 await**。
用普通对象包装结果，不破坏 Promise 链
async 函数本身必须返回 Promise；你不能让它“返回普通对象”却还指望 await 正常工作。正确做法是：在函数体内构造自定义结果对象，并 return 它——JavaScript 会自动把它包装进 Promise.resolve()。
例如：
async function fetchUser() {
try {
const res = await fetch('/api/user');
const data = await res.json();
return { success: true, data, timestamp: Date.now() }; // ✅ 自动变成 Promise.resolve({...})
} catch (err) {
return { success: false, error: err.message, timestamp: Date.now() }; // ✅ 同样被包装
}
}
// 调用方：
const result = await fetchUser(); // result 就是那个自定义对象
console.log(result.success); // true 或 false
统一处理成功与失败（避免 throw，全走 return）
如果希望调用方**永远不用 try/catch**，且所有结果都走同一结构（即“不抛异常”），可把错误也转为正常返回值：
立即学习“Java免费学习笔记（深入）”；
- 在
catch块里不throw，而是return错误形态的对象 - 确保所有分支（包括条件判断）最终都有
return，避免隐式返回undefined - 这样调用方只需检查
result.success，无需try/catch
需要更明确控制 Promise 状态？手动返回 Promise
极少数场景下（如需延迟 resolve、或动态决定 resolve/reject），可显式返回 new Promise(...)，但注意：这会覆盖 async 函数的自动包装行为，所以要自己保证返回的是 Promise：
async function fetchWithTimeout() {
return new Promise((resolve) => {
setTimeout(() => {
resolve({ success: true, data: 'timeout-safe' });
}, 1000);
});
}
⚠️ 注意：此时函数虽标记为 async，但实际没用到 await，纯属“占位”；若无 await，可直接写普通函数 + 返回 Promise，async 反而多余。
封装成可复用的工具函数（如 safeAsync）
若多个地方都需要这种“全成功返回”的模式，可抽象一个高阶函数：
function safeAsync(fn) {
return async (...args) => {
try {
const data = await fn(...args);
return { success: true, data };
} catch (error) {
return { success: false, error: error instanceof Error ? error.message : String(error) };
}
};
}
// 使用：
const safeFetchUser = safeAsync(() => fetch('/api/user').then(r => r.json()));
const result = await safeFetchUser(); // 结构固定：{ success, data? | error? }
