Oracle DCN 依赖数据库AQ服务，需启用DBMS_AQADM、授权ENQUEUE/DEQUEUE及ENABLE_BROKER；Java端须用OracleDataSource禁用连接池，长期持有连接；事件仅通知表变更，不提供行级详情，回调需轻量、幂等且避免操作原连接。

Oracle DCN 要求数据库端必须开启 AQ（Advanced Queuing）

dcn 不是纯客户端机制，它依赖 oracle 数据库的队列服务来异步推送变更事件。如果 dbms_aqadm 未启用、用户无 enqueue_dequeue 权限，或者数据库未启用 enable_broker，注册监听会静默失败或抛出 ora-24915。

• 确认数据库已运行：SELECT queue_table FROM dba_queues WHERE owner = 'SYS' AND name = 'SYS$SERVICE_QUEUE';
• 应用用户需显式授权：GRANT EXECUTE ON DBMS_CHANGE_NOTIFICATION TO your_user; 和 GRANT ENQUEUE_ANY, DEQUEUE_ANY TO your_user;
• 监听注册时若返回 null 或 SQLException 但无明确错误码，大概率是 AQ 未就绪，不是 Java 代码问题

Java 端注册 DCN 必须用 OracleDataSource + setConnectionCachingEnabled(false)

Oracle JDBC 驱动对 DCN 的连接状态极其敏感：连接池会复用物理连接，但 DCN 注册绑定的是具体连接句柄（OracleConnection），一旦连接被池回收或重用，通知就彻底丢失，且不报错。

• 必须用 OracleDataSource（不能用 HikariDataSource 或 BasicDataSource）
• 禁用连接缓存：ods.setConnectionCachingEnabled(false);
• 注册后不能调用 connection.close()，否则监听立即失效；应长期持有该连接并保持活跃（如定期 connection.isValid(5)）
• 示例关键段：

  OracleConnection conn = (OracleConnection) ods.getConnection();
  conn.registerDatabaseChangeNotification(dcnListener); // dcnListener 是自定义实现

DCN 事件类型有限，不等于行级变更日志

DCN 只通知「表结构或数据发生变更」，不提供变更前/后值、不区分 INSERT/UPDATE/DELETE、也不告知哪几行变了。它本质是轻量级“戳一下”信号，适合触发缓存刷新或下游拉取，不适合做审计或同步。

• 事件类型只有：TABLE_EVENT（含 INSERT_EVENT、UPDATE_EVENT、DELETE_EVENT 等常量），但实际收到的 ObjectChangeDescription 中 getObjectType() 多数情况下返回 TABLE，而非具体操作类型
• 若需精确变更内容，必须配合触发器写入日志表，或改用 Oracle GoldenGate / LogMiner
• 一个 DatabaseChangeRegistration 可监听多张表，但所有表共享同一个回调，需在 listener 里自行判断 getTableChangeDescription().getTableName()

监听器回调不在主线程，且可能被重复触发

onChange(DatabaseChangeEvent e) 回调由 Oracle JDBC 内部线程池调用，和你的业务线程完全隔离。如果回调里做耗时操作（如远程 HTTP 请求、复杂计算），会阻塞整个 DCN 事件队列，导致后续变更堆积或丢失。

• 务必在回调中只做轻量动作：比如往 BlockingQueue 丢个 tableName，再由独立线程消费
• Oracle 可能因网络抖动或重连，对同一变更发多次事件，回调里要有幂等判断（例如用 e.getTimestamp() 去重，或结合表名+时间窗口缓存）
• 不要在回调里直接操作原 Connection —— 它可能已被 JDBC 内部关闭或切换，应另建新连接查数据

DCN 的脆弱性集中在数据库配置、连接生命周期和事件语义这三点上，任意一环没对齐，就会表现为“明明注册了却收不到通知”，而错误日志往往安静得反常。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南