oracle aq的jms使用必须通过jndi+ldap/oid注册，依赖dbms_aq等系统包，不支持直连；xa连接工厂支持分布式事务，非xa用于异步解耦；消费失败多因权限、队列未启动或字符集非al32utf8。
能用，但必须走jndi + oracle aq专属jms实现，原生jms api直接连不上。oracle aq不是kafka或activemq那种独立消息中间件，它本质是数据库内建的队列服务，jms层只是封装了一套标准接口，底层仍强依赖oracle的jndi注册、连接工厂绑定和aq系统包（dbms_aq、dbms_aqadm）——跳过这些环节，connectionfactory.createconnection() 会直接抛 javax.naming.namingexception 或空指针。
为什么必须配置LDAP / OID才能用JMS？
Oracle AQ的JMS实现不支持“直连式”JNDI（比如用java.naming.provider.url=jdbc:oracle:thin:@...）。它的ConnectionFactory和Queue/Topic对象必须预先注册到LDAP目录（通常是Oracle Internet Directory），JMS客户端通过InitialContext查到的是LDAP里存的引用，再由AQ驱动解析成数据库内部队列操作。
- 不配OID/LDAP →
InitialContext.lookup("jms/AQjmsXAConnectionFactory")报NameNotFoundException - 即使绕过JNDI手动new
AQjmsConnectionFactory，也会因缺少aqapi.jar与数据库会话绑定逻辑而失败 - 开发阶段可临时用嵌入式
OracleAQInitialContextFactory（仅限测试），但生产环境必须走LDAP
AQjmsXAConnectionFactory vs AQjmsConnectionFactory 怎么选？
关键看事务边界：是否要让JMS收/发和数据库DML落在同一个JTA事务里。
- 用
AQjmsXAConnectionFactory→ 支持XA事务，session.commit()同时提交SQL和出队动作，避免“消息已消费但DB更新失败”的状态不一致 - 用
AQjmsConnectionFactory→ 非XA，出队/入队走独立事务，适合异步解耦场景，但需自行处理幂等或补偿 - 两者都要求连接URL中带
tns_alias或完整TNS描述符，不能只写localhost:1521:ORCL（否则报ORA-12154）
消费端卡住不触发onMessage()？检查这三处
常见现象是MessageConsumer.setMessageListener()设了，但队列有消息就是不回调——大概率是订阅生命周期或权限没对齐。
- Topic消费必须先调用
connection.setClientID("xxx")，否则createDurableSubscriber()失败，且错误被静默吞掉 - Queue消费若用
receive()阻塞模式，需确认队列已START_QUEUE（DBMS_AQADM.START_QUEUE），否则永远等待 - 用户权限缺
DEQUEUE_ANY或没被显式授权具体队列（DBMS_AQADM.GRANT_QUEUE_PRIVILEGE('dequeue','MY_Q','APP_USER',FALSE)），会静默跳过消息
最麻烦的其实是字符集——如果数据库字符集不是AL32UTF8，JMS收到的TextMessage中文会变乱码，且这个错误不会抛异常，只默默损坏payload。改库字符集要停库，不是加个JVM参数能解决的。
立即学习“Java免费学习笔记（深入）”；
