Oracle中MERGE INTO必须用ON子句基于主键或唯一列设等值条件，禁止在ON中更新字段；源数据须为SELECT子查询；UPDATE/INSERT字段需与源列严格对齐；NULL值须用NVL/COALESCE标准化；过滤条件应下推至USING子查询以保性能。
Oracle中MERGE INTO的正确写法和必须指定的条件
MERGE INTO 不是万能的“upsert”，它要求明确区分匹配与不匹配的判断逻辑，核心在于
子句必须提供可精确评估的等值条件（通常基于主键或唯一约束列），否则会报错
。
常见错误是把要更新的字段也放进
条件里，比如写成
—— 这会导致 Oracle 认为你要在匹配时修改
，违反语法限制。
子句只用于判断“行是否存在”，只能包含连接键（如
、
），不能含待更新字段
匹配后更新哪些字段、插入哪些字段，全部由
和
分开控制
源数据必须来自
子查询（哪怕只查一行），不能直接写值列表；若需单行 upsert，可用
MERGE INTO中UPDATE和INSERT的字段对齐规则
UPDATE 部分的
列表和 INSERT 部分的字段列表，都必须严格对应源子查询（
后的 SELECT）的列别名或位置，且类型兼容。Oracle 不做隐式转换，类型不一致会直接报错
。
典型陷阱是源查询里用字符串拼接或函数处理字段，导致目标列无法赋值。例如目标表
，但源查了
，虽然别名一样，但长度语义已变，某些版本会触发截断警告甚至失败。
INSERT 的字段括号内列名顺序，必须和
中表达式的顺序完全一致
UPDATE 的
后面推荐显式写
，避免因别名冲突误赋值
如果源查询有计算字段（如
），INSERT 时直接用
，不要重复写表达式
如何安全处理NULL值匹配和唯一约束冲突
当连接键字段可能为
时，
永远不成立（因为
为 FALSE），导致所有行都被当作“不存在”而执行 INSERT，极易违反唯一约束报
。
oracle知识库
oracle知识库下载
下载
解决方法不是改用
判断（MERGE 的
不支持复杂布尔逻辑），而是提前清洗或改用 NVL/COALESCE 统一空值标记：
永远不要在
中直接比较可能为 NULL 的列，必须用
、
或函数标准化
如果业务上 NULL 确实代表“任意值”或“通配”，MERGE 本身不适用，应拆成先
再分步处理
并发场景下，即使加了唯一索引，MERGE 仍可能因读写间隔产生冲突，建议外层加异常捕获（
）兜底
性能关键：WHERE子句必须下推到USING子查询中
MERGE 的
子查询若未加过滤，会把全量数据拉进内存再逐行匹配，即使最终只影响几行，也会严重拖慢执行速度。Oracle 不会自动将
的条件下推到驱动查询。
正确做法是把业务过滤条件写在
的 SELECT 里，而不是塞进
：
子查询务必带
，尤其源表很大时，这是性能分水岭
避免在
后加
——它只控制是否执行更新动作，不减少匹配扫描量
确保
中的连接字段有索引，否则 MERGE 会走全表扫描+嵌套循环，比单独 UPDATE/INSERT 更慢
实际用起来最麻烦的往往不是语法，而是 NULL 处理和并发冲突——这两点没压住，MERGE 看似简洁，运行起来却比分开写更难 debug。
ONORA-38104: Columns referenced in the ON Clause cannot be updatedONON (t.id = s.id AND t.status = s.status)t.statusONidcodeWHEN MATCHED THEN UPDATE SET ...WHEN NOT MATCHED THEN INSERT ...SELECTSELECT ... FROM DUALSETUSINGORA-00932name VARCHAR2(50)UPPER(name) AS nameVALUESSETcolumn = source.columnSYSDATE + 1 AS next_datenext_dateNULLON (t.col = s.col)NULL = NULLORA-00001IS NULLONMERGE INTO target t
USING (SELECT id, NVL(code, '-1') AS code, name FROM source) s
ON (t.id = s.id AND t.code = s.code)
WHEN MATCHED THEN UPDATE SET t.name = s.name
WHEN NOT MATCHED THEN INSERT (id, code, name) VALUES (s.id, s.code, s.name);ONNVLCOALESCESELECT COUNT(*)EXCEPTION WHEN DUP_VAL_ON_INDEXUSINGWHEN MATCHED THEN UPDATE WHERE ...USINGUPDATE SET ... WHERE-- ✅ 好：过滤在源头
MERGE INTO orders t
USING (SELECT * FROM staging_orders WHERE status IN ('NEW', 'PENDING')) s
ON (t.order_id = s.order_id)
WHEN MATCHED THEN UPDATE SET t.status = s.status
WHEN NOT MATCHED THEN INSERT VALUES (s.order_id, s.status, s.amount);
-- ❌ 差：WHERE在UPDATE里，全量staging_orders先加载
WHEN MATCHED THEN UPDATE SET t.status = s.status WHERE s.status IN ('NEW', 'PENDING')
USINGWHEREWHEN MATCHED THEN UPDATEWHEREON