add()抛异常,offer()返回false:队列满时add()抛illegalstateexception,offer()静默返回false;无界队列二者行为一致但语义不同;priorityqueue中add()实际调用offer(),不因“满”失败;put()会阻塞等待。

add() 会抛异常,offer() 只返回 false
这是最根本的区别:当队列已满(比如 ArrayBlockingQueue 达到容量上限),add() 直接抛出 IllegalStateException;而 offer() 安静地返回 false,不打断程序流。
- 如果你的代码没包 try-catch,用
add()在满队列时必然 crash,日志里看到java.lang.IllegalStateException: Queue full -
offer()更适合“尽力而为”的场景——比如日志缓冲、异步任务提交,失败了就丢弃或降级处理 - 注意:对无界队列(如
LinkedBlockingQueue默认构造、ConcurrentLinkedQueue)来说,add()和offer()行为完全一致(都总成功),但语义仍不同——前者承诺“必须加进去”,后者承诺“尽量加”
什么时候该用 add(),什么时候该用 offer()?
看你的业务能否容忍“插入失败”以及是否愿意处理异常路径。
- 用
add():你**要求强一致性**,比如任务调度系统中,一个定时任务必须进队,否则整个流程要告警/重试/回滚 - 用
offer():你接受**柔性失败**,比如埋点上报队列满了,就跳过这次上报,不影响主链路 - 别在循环里盲目用
add()往有界队列塞数据——没做容量预估或背压控制的话,第一次满就炸
PriorityQueue 是个特例:add 和 offer 实际是同一个方法
翻 JDK 源码就知道,PriorityQueue.add(E) 内部直接调用了 offer(E),且它本身无容量限制(除非显式传了 initialCapacity 并触发扩容失败,但那是 OOM 级别问题,不是队列满)。
- 所以对
PriorityQueue来说,add()永远不会抛IllegalStateException,也不会因“满”失败 - 但它可能抛
NullPointerException(元素为 null)或ClassCastException(元素不可比),这些和“满不满”无关,是类型契约问题 - 别因为
PriorityQueue的行为,误以为所有 Queue 实现都这样——ArrayBlockingQueue和LinkedBlockingQueue(有界构造)就严格区分
阻塞队列里还有个 put(),它和 add()/offer() 不是同一类操作
put(E) 是 BlockingQueue 接口的方法,和 add()/offer() 不同源,行为也更激进:队列满时不是抛异常也不是返回 false,而是**线程挂起等待空位**。
立即学习“Java免费学习笔记(深入)”;
- 这意味着:用
put()前必须确认调用线程能接受阻塞(比如后台线程),千万别在 Tomcat 的请求线程里无 timeout 地调用它 -
offer(E, long, TimeUnit)才是带超时的“友好版 put”,建议替代无参put()使用 - 混用接口容易踩坑:比如变量声明为
Queue类型,实际是ArrayBlockingQueue,你只能调add()或offer();只有声明为BlockingQueue才能用put()
add() 把“失败”当作异常情况,offer() 把“失败”当作正常分支。选错一个,轻则日志刷屏,重则线程卡死或任务静默丢失。










