漏写 await 会导致并发逻辑失控、状态竞争和错误静默；可通过运行时错误、网络请求异常和异步堆栈定位，并用 require-await、no-floating-promises 等 ESLint 规则主动防御。
async 函数里漏写 await，表面看只是少打两个字母，实际却可能让并发逻辑彻底失控：本该串行等待的变成并行乱跑，本该顺序执行的变成状态竞争，甚至请求发出去了却没人等结果、错误永远不抛出、日志静默丢失。这类问题难复现、难定位，但有明确的排查路径和可落地的 Lint 防御机制。
识别典型漏 await 场景
以下代码看似合理，实则埋雷：
- 调用异步函数但没 await，返回的是未处理的 Promise 对象（如
fetch('/api/user')而非await fetch('/api/user')），后续逻辑继续执行，完全不受其完成状态约束 - 在 if/for/while 等分支或循环中调用异步函数，只在部分分支加 await，其他分支遗漏，导致控制流不一致
- 将 async 函数直接赋值给变量或传入回调（如
const handler = async () => {...}; button.onclick = handler;），既没 await 也没显式 .catch，错误被吞、行为不可控 - Promise 构造函数里误用 async（
new Promise(async (res, rej) => {...})），违反no-async-promise-executor规则，异常无法被捕获
快速定位漏 await 的运行时线索
靠肉眼扫代码效率低，优先借助运行时信号缩小范围：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 控制台出现
Uncaught (in promise) ...或Unhandled promise rejection，说明有 Promise 被拒绝但无人监听——立刻检查该错误堆栈附近所有异步调用点是否缺失 await 或 catch - 接口请求发出但无响应、页面卡在 loading、数据渲染为空，且 Network 面板显示请求已成功返回——大概率是 fetch 后没 await response.json()，或整个链路漏 await 导致后续 render 提前执行
- 多个本应串行的操作（如“先保存再跳转”）出现跳转后页面仍显示旧数据，或保存失败但跳转已发生——检查 save() 调用处是否遗漏 await
- 使用
asyncio.run(main(), debug=True)（Python 类比思路）不适用 JS，但可开启 Chrome 的 Async Stack Trace：DevTools → Settings → Preferences → Sources → ✅ “Enable async stack traces”，让错误堆栈保留 await 上下文
用 ESLint 规则主动拦截
把防御做在编码阶段，推荐配置以下核心规则：
- require-await：强制所有含 async 关键字的函数内至少有一个 await 表达式。避免“假 async”——声明为 async 却同步执行，误导维护者
- no-floating-promises（@typescript-eslint）：禁止未处理的 Promise。任何 Promise 实例若未被 await、未传入 Promise.all、未接 .then/.catch，即报错。这是防漏 await 的第一道闸门
- promise-function-async：要求所有返回 Promise 的函数必须标记为 async。从源头统一异步函数签名，降低“该不该 await”的判断成本
-
no-await-in-loop：虽非直接防漏 await，但能揪出“本该并行却写成串行”的反模式（如循环里逐个 await fetch）。配合注释
// eslint-disable-line no-await-in-loop可保留必要串行逻辑
修复与加固建议
发现漏 await 后，不只是补上关键字，更要审视设计意图：
- 确认调用目标确实是异步函数（返回 Promise），而非普通函数。TypeScript 类型标注能提前暴露
Promise<void></void>与void的混淆 - 若需并行执行多个独立异步操作，改用
await Promise.all([p1(), p2(), p3()])，而非逐个 await —— 这不是漏写，而是主动优化 - 对关键副作用操作（如 API 写入、状态更新），即使调用方已 await，也应在函数内部用 try/catch 包裹，避免异常穿透破坏流程
- 在 CI 流程中集成 Lint 检查，禁止
no-floating-promises报错的代码合入主干，形成硬性防线
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
