Java Condition.awaitNanos 返回值怎么判断是否超时

我第一次把 Condition.awaitNanos() 接进带超时的等待逻辑时，最容易误读的不是纳秒单位，而是它的返回值。它返回的不是“是否成功”的布尔值，而是本轮返回时估算的剩余等待时间：大于 0 说明还有时间可等，小于等于 0 才表示等待预算已经耗尽。

因此，判断超时的关键写法是 nanosRemaining ，但这个判断必须放在重新检查业务条件之后。线程可能因为 signal() 或虚假唤醒返回，此时条件并不一定已经成立。

官方 API：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/locks/Condition.html

先把返回值从“结果”改回“剩余预算”

awaitNanos(long nanosTimeout) 接收本次最多等待的纳秒数，返回的是“输入预算减去已经等待时间”的估算值。这个值为正时，可以继续作为下一次等待的参数；小于等于零时，代表已经没有剩余时间。

long nanosRemaining = TimeUnit.MILLISECONDS.toNanos(timeoutMillis);
lock.lock();
try {
    // 返回值是剩余预算，不是“收到通知”的布尔结果
    nanosRemaining = condition.awaitNanos(nanosRemaining);
    boolean timedOut = nanosRemaining 

我后来把变量名从 result 改成 nanosRemaining，误读明显少了。命名直接提示了下一步动作：如果条件还没满足，就把它带回下一轮，而不是把它当成一次通知是否成功的结果。

条件循环里怎样判断真正超时

定时等待通常要围绕一个共享状态谓词循环。每次从 awaitNanos 返回，都先检查条件是否成立；只有条件仍不成立且剩余时间小于等于零，才返回超时。这样既能处理正常通知，也能覆盖虚假唤醒或多个等待线程竞争同一个状态的情况。

boolean awaitReady(long timeout, TimeUnit unit)
        throws InterruptedException {
    long nanosRemaining = unit.toNanos(timeout);
    lock.lock();
    try {
        while (!ready) {
            // 预算耗尽后不再调用 awaitNanos，直接报告超时
            if (nanosRemaining 

这里有一个看起来细小、实际很重要的顺序：while (!ready) 负责回答“业务条件是否成立”，nanosRemaining 负责回答“等待预算是否耗尽”。两者不能互相替代。

迁移旧写法时最容易漏掉的三件事

如果旧代码把 awaitNanos 的返回值直接当作一次等待结果，迁移时我会按下面三点改。

• 把一次性判断改成循环：通知只意味着可以重新竞争锁，不代表 ready 已经为真。
• 保存每轮剩余值：不要每次循环都用原始超时时间重置，否则多次唤醒会把总等待时间拉长。
• 保留中断语义：awaitNanos 可能抛出 InterruptedException。是否向上抛出、转换为业务结果或恢复中断标志，要由调用方的取消协议决定，不能把中断悄悄当成超时。

另外，调用 awaitNanos 前必须持有创建该 Condition 的关联锁。它不是普通的计时器，也不是只要拿到 Condition 对象就可以调用的工具方法。

用三类回归结果确认改对了

我会准备三个小场景，而不是只看“方法最终返回了 false”。第一类是在预算耗尽前把 ready 设为 true，结果应为 true；第二类持续不满足条件直到返回值小于等于零，结果才是超时；第三类在等待期间中断线程，应该得到约定的中断处理，而不是伪装成普通超时。

常见问题

awaitNanos 返回 0 是否说明被 signal 唤醒？ 不是。小于等于零只说明没有剩余等待时间；被通知、虚假唤醒和超时都可能影响返回时机，所以仍要检查业务条件。

为什么不能每次循环重新计算原始 timeout？ 因为每次唤醒都会重新获得一整段预算，累计等待时间可能超过调用方允许的总时长。应把上一次返回的剩余纳秒数传给下一次调用。

awaitNanos 和 await(long, TimeUnit) 怎样选？ 如果只需要一次布尔结果，后者更直观；如果要在条件循环中重用剩余预算，awaitNanos 的返回值更适合表达这一过程。

最后可以把判断压缩成一句话：ready 决定业务是否完成，nanosRemaining 决定等待是否耗尽，InterruptedException 决定是否进入中断处理。把这三种信号分开，awaitNanos 的超时判断就不会再混乱。