ORA-00933错误源于SQL语法未正确结束，主因包括：语句末尾误加英文分号、换行/空格错乱、子句顺序错误、关键字拼写错误、括号不匹配或中文标点混用，尤其在ExecuteSqlRaw中MERGE INTO需严格遵循Oracle语法且禁用分号。
ExecuteSqlRaw里写MERGE INTO，为什么总报ORA-00933？
因为executesqlraw默认走的是标准sql解析路径，而oracle的merge into语法不被ef core原生识别为“可执行语句”，尤其当语句末尾没加分号、或混用了c#字符串插值导致换行/空格错乱时，oracle会直接抛ora-00933: sql command not properly ended。
实操建议：
- 确保整个
MERGE INTO语句是单行字符串，或用@""逐行拼接但**每行末尾不能有多余空格** - 语句结尾**不要加英文分号**（
;），EF Core会自动处理终结符 - 避免在
ON或WHERE里用C#插值拼接字段名——必须用参数化占位符，例如:id，否则触发SQL注入检测并报错 - 如果源数据来自内存集合，别直接在SQL里写
VALUES (1,'a',...)；改用USING (SELECT ... FROM DUAL)或临时表，否则Oracle无法绑定批量参数
参数怎么传才不触发ORA-01722或隐式转换？
Oracle对参数类型极其敏感。ExecuteSqlRaw传int?给NUMBER列一般没问题，但一旦源字段是VARCHAR2(10 CHAR)而你传了string带空格或超长，就可能报ORA-01722: invalid number（尤其是字段实际存数字但类型是字符型时）。
实操建议：
- 目标表关联字段（如
ON t.id = s.id中的id）两端类型必须严格一致：都是NUMBER，或都是VARCHAR2且长度足够 - 用
new OracleParameter("id", OracleDbType.Int32) { Value = 123 }显式声明类型，别依赖自动推断 - 字符类参数统一用
OracleDbType.Varchar2并设Size（比如Size = 100），防止Oracle按默认1字符截断 - 日期字段务必用
OracleDbType.Date，传DateTime.Now，别传字符串格式如"2026-04-29"
大批量Merge时卡住或UNDO爆满，怎么办？
EF Core的ExecuteSqlRaw默认在一个事务里执行整条MERGE INTO。若一次同步10万行，Oracle会把所有变更记进UNDO段，极易触发ORA-30036: unable to extend segment，同时锁表时间过长，阻塞其他业务。
实操建议：
- 手动分批：把源数据按
id或时间范围切片（如每次5000行），每批单独调用ExecuteSqlRaw，并在批次间加await context.SaveChangesAsync() - 禁用自动事务：用
context.Database.BeginTransaction()控制粒度，失败时只回滚当前批，不影响全局 - 关键字段加索引：确保
ON子句里的字段（如t.order_id = s.order_id）在目标表和源表（或子查询结果）上都有B-tree索引，否则全表扫描拖垮性能 - 避免在
USING里写复杂子查询——先用INSERT /*+ APPEND */ INTO temp_staging把源数据落地到临时表，再USING temp_staging，稳定性翻倍
为什么Merge后查不到新数据，或重复插入报主键冲突？
最常见原因是ON条件没覆盖全，或源数据本身含重复键。Oracle的MERGE INTO要求USING结果集对每个匹配键最多一行，否则直接报ORA-30926: unable to get a stable set of rows——但这个错误有时被EF Core吞掉，只表现为空操作或静默失败。
实操建议：
- 执行前先验证源数据：
SELECT order_id, COUNT(*) FROM staging_table GROUP BY order_id HAVING COUNT(*) > 1，有重复必须去重 -
ON里只放纯关联逻辑，比如t.id = s.id；业务过滤（如s.status = 'ACTIVE'）一律移到WHEN MATCHED THEN UPDATE SET ... WHERE s.status = 'ACTIVE' - 如果源是子查询，用
ROW_NUMBER() OVER (PARTITION BY id ORDER BY updated_time DESC)保底取最新一条，避免歧义 - 执行后立刻查
SQL%ROWCOUNT（需用ExecuteSqlInterpolated配合OUT参数）确认影响行数，别只信返回值
真正难的不是写出能跑的MERGE语句，而是让它的ON稳定、USING干净、UPDATE和INSERT分支互不干扰——这三点漏掉任一个，线上就容易出脏数据或锁死。
