症状与错误信息
运行 JavaScript 代码时，运行时抛出以下错误（错误信息保留英文原文）：
(No error — function returns a Promise instead of the resolved value; side effects happen later)该错误表明：诊断调用 async 函数时未加 await 导致调用方在异步工作完成前继续执行的问题。一旦触发条件满足，错误即可稳定复现。在生产环境中可能间歇出现，因为触发条件依赖运行时状态，并非始终存在。
根因分析
根本原因是：forgetting await means the async function starts but the caller does not wait for it, leading to a promise where a value is expected and race conditions.两个因素叠加才产生可见错误。第一，an async function is called without await, so the caller gets a promise, not the result.第二，a foreach loop is used instead of for-of with await, so async iterations run in parallel and out of order.单独一个因素可能不会触发，但两者同时存在即构成失败条件。
诊断步骤
首先在隔离环境中复现错误，剥离除最小触发路径外的所有代码。获得最小复现后，检查失败点的每个变量：本应为对象却为 undefined、类型不符、引用过期、索引越界等。错误信息说明“出了什么问题”，周围状态说明“为什么出问题”。
修复与代码示例
// 修复前（有缺陷）
// ... 触发错误的代码 ...
// 修复后（已修正）
// ... 加入守卫或类型检查的修正代码 ...修复直接针对根因：add await before every async function call, and use for-of (not foreach) when sequential awaiting is needed.应用修复后，触发条件被阻止或被优雅处理，错误不再发生。
验证
Check that the function returns the resolved value, not a Promise; add an eslint rule require-await.重新运行复现用例确认错误消失，然后运行完整测试套件检查回归。生产环境需监控错误日志 24 小时，确认修复在真实负载下有效。
常见陷阱
常见错误是用 try/catch 或条件判断抑制错误而不处理根因。这只是掩盖症状，缺陷逻辑仍在，错误会以不同形式再次出现。务必修复根因而非仅消除错误信息。另一陷阱是只修了正常路径而忽略空输入、null 值、并发访问等边界情况。