Oracle的RAW(16)不能直接当Guid用，因其是二进制类型而C# Guid是结构体，ODP.NET默认映射为byte[]而非Guid，需通过HasConversion显式配置双向转换。
EF Core 默认不识别 Oracle 的 RAW(16) 为 Guid 类型，必须显式配置，否则会报类型不匹配或隐式转换失败。
为什么 RAW(16) 不能直接当 Guid 用？
Oracle 的 RAW(16) 是二进制类型，而 C# 的 Guid 是结构体；ODP.NET（包括 Oracle.EntityFrameworkCore）默认把 RAW 映射为 byte[]，不是 Guid。哪怕数据库字段值是 SYS_GUID() 生成的，EF Core 查询出来也是 byte[16]，.Where(x => x.Id == someGuid) 会直接报错或查不到。
- 常见错误现象：
System.InvalidCastException: Unable to cast object of type 'System.Byte[]' to type 'System.Guid' - 即使手动 new
Guid(byteArray)，EF Core 生成的 SQL 仍可能把参数当作VARBINARY或VARCHAR2，导致 Oracle 端比较失败 - 在 EF Core 7+ 和
Oracle.EntityFrameworkCore7.x/8.x 中，这个问题依然存在，没有自动适配
在 OnModelCreating 中用 HasConversion 显式声明映射
这是最稳定、最可控的方式，让 EF Core 知道：这个属性逻辑上是 Guid，物理存储是 RAW(16)，读写时自动双向转换。
示例（假设实体类中有个 Id 属性）：
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<MyEntity>()
.Property(e => e.Id)
.HasColumnType("RAW(16)")
.HasConversion(
guid => guid.ToByteArray(), // Guid → byte[]
bytes => new Guid(bytes) // byte[] → Guid
);
}- 必须同时指定
.HasColumnType("RAW(16)")，否则 Oracle 提供程序可能 fallback 到VARCHAR2或HEXTORAW自动转换，不可靠 - 不要用
ToString()或BitConverter.ToString(...).Replace("-", "")做转换 —— 那是字符串格式，不是原始字节顺序，Oracle 会按字节比对，顺序错就查不到 - 确保数据库字段确实是
RAW(16)，不是VARCHAR2(32)或CHAR(32)，否则插入时会触发隐式类型转换警告甚至失败
插入新记录时如何生成 SYS_GUID()？
EF Core 不会自动调用 Oracle 的 SYS_GUID() 函数，需要手动干预或用数据库默认值。
- 方式一（推荐）：在数据库建表时设默认值
DEFAULT SYS_GUID()，C# 端不赋值，EF Core 插入时留空，由 Oracle 自动生成 - 方式二：在
OnModelCreating中配置ValueGeneratedOnAdd()，但需配合自定义值生成器（IValueGenerator），且必须返回byte[16]而非字符串 - 方式三（不推荐）：C# 端用
Guid.NewGuid().ToByteArray()生成，但丢失了SYS_GUID()包含的主机/时间戳信息，分布式场景下熵略低 - 注意：如果用了
ValueGeneratedOnAdd()，就不能再设HasDefaultValueSql("SYS_GUID()")，否则 Oracle 可能报ORA-01400（空值插入）
查询时带 Guid 参数的注意事项
EF Core 生成的 SQL 中，WHERE id = :p0 的参数类型取决于你是否正确配置了 HasConversion。没配好时，参数常被当成 VARCHAR2，Oracle 会尝试隐式转 HEXTORAW，但大小写、长度稍有偏差就查不到。
- 验证方法：开启 EF Core 日志，看生成的 SQL 参数类型是不是
RAW - 若仍出问题，可临时强制指定参数类型：
context.MyEntities.FromSqlRaw("SELECT * FROM my_table WHERE id = HEXTORAW({0})", guidString)，但破坏了 LINQ 抽象，仅限紧急绕过 - 特别注意：Oracle 对
RAW比较严格，Guid.Empty.ToByteArray()是 16 个0x00，对应 RAW 值为00000000000000000000000000000000，不能用''或NULL替代
最容易被忽略的是字节序 —— Guid.ToByteArray() 输出的是 little-endian 序列，而 Oracle SYS_GUID() 生成的 RAW 也是按相同字节序存储的，所以直接转换是安全的；但如果你从字符串解析（比如前端传来的 UUID 字符串），一定要用 Guid.Parse() 或 Guid.TryParse()，别自己拆分十六进制字符串重排字节。
