oracle多表join映射失败主因是字段名冲突与spliton失效，须为重名列显式加别名且spliton严格匹配首列；列别名超长被截断或转大写需统一小写下划线命名；空字符串非null需cast或nvl转真正null；分页须用offset fetch避免rownum错位。
Oracle多表JOIN结果映射失败：字段名冲突或splitOn失效
Oracle默认不区分大小写，但Dapper的splitOn参数严格按列名字符串匹配——如果SELECT里写了u.id, r.id，两个id字段会覆盖，splitOn: "id"就找不到第二个实体的起始列。这不是Dapper bug，而是Oracle返回的元数据中列名未带别名导致的歧义。
- 必须为所有可能重名的字段显式加别名，例如
u.id AS user_id, r.id AS role_id -
splitOn值必须与SQL中**第一个非前缀列名**完全一致（大小写敏感），比如splitOn: "role_id"对应r.name AS role_name - 若用
Query<t1 t2 treturn>()</t1>，确保SQL中列顺序是T1字段在前、T2字段紧随其后，中间不能穿插其他列 - 避免用
SELECT *，Oracle视图或复杂子查询可能导致列序不可控
映射到匿名类型或Dynamic时字段丢失：Oracle列别名被截断
Oracle对列别名长度限制为30字符，且自动转为大写。当你写SELECT user_created_time AS userCreatedTime FROM ...，Oracle实际返回的列名是USERCREATEDTIME，而C#的dynamic或ExpandoObject按原样访问userCreatedTime会报错RuntimeBinderException。
- 在SQL中统一用下划线命名并全小写别名：
user_created_time AS user_created_time - 或者在C#侧用
Get<dynamic>()</dynamic>后手动取值：obj["USER_CREATED_TIME"] - 若必须驼峰，改用
Query<dictionary object>>()</dictionary>，再遍历Key做ToLower()或Replace("_", "")映射
LEFT JOIN空关联行映射为null失败：Oracle返回空字符串而非NULL
Oracle对VARCHAR2类型空值常返回空字符串''而非SQL NULL，导致Dapper把空字符串赋给可空引用类型（如string RoleName）没问题，但赋给可空值类型（如int? RoleId）时抛InvalidCastException——因为Dapper尝试把""转成int。
- 在SQL中强制转换：
CAST(r.id AS NUMBER) AS role_id，让Oracle对空值返回真正NULL - 或用
NVL(r.id, NULL)（Oracle 12c+支持） - 实体类对应属性必须声明为可空类型：
public int? RoleId { get; set; }，不可用int - 不要依赖
[Column("role_id")]解决此问题，它只管名称映射，不处理空值语义
性能陷阱：JOIN后分页时ROWNUM错位
Oracle传统ROWNUM 分页在多表JOIN场景下会先取N行再JOIN，导致分页结果漏数据。Dapper执行<code>Query<t>("SELECT * FROM (...) WHERE ROWNUM 看似正常，实则逻辑错误。</t>
- 必须用Oracle 12c+的
OFFSET ... FETCH语法：SELECT * FROM users u LEFT JOIN roles r ON u.role_id = r.id ORDER BY u.id OFFSET 0 ROWS FETCH NEXT 10 ROWS ONLY - 旧版本Oracle需嵌套查询：
SELECT * FROM (SELECT a.*, ROWNUM rnum FROM (your_join_sql) a WHERE ROWNUM 0 - Dapper不干预SQL语义，分页逻辑完全由你写的SQL决定，别指望
Query<t>().Skip().Take()</t>能自动生成正确Oracle分页
字段别名和空值处理这两块最容易被跳过测试，上线后查半天才发现是Oracle侧返回了空字符串或截断的列名。
