Oracle 19c+原生JSON列在.NET 8中不能用GetString()直接读取，因其映射为内部二进制OSON格式，GetString不识别该类型，导致乱码或InvalidCastException；必须用GetFieldValue()触发驱动内置JSON-to-string转换。
Oracle 19c+ 的原生 JSON 列在 .NET 8 中不能用 GetString() 直接读取，必须显式指定类型映射；否则会返回乱码（如 0x7B2261223A317D）或抛出 InvalidCastException。
为什么 GetString() 在 Oracle JSON 列上失效
Oracle 19c 引入了独立的 SQL 类型 JSON，ojdbc 驱动（.NET 使用的是 Oracle.ManagedDataAccess）将其映射为内部二进制格式（OSON），而非字符串。.NET 的 OracleDataReader.GetString() 不识别该类型，底层尝试转换失败，最终返回原始字节流的十六进制表示或直接崩溃。
常见错误现象：
System.InvalidCastException: Unable to cast object of type 'Oracle.ManagedDataAccess.Types.OracleJson' to type 'System.String'- 返回值类似
"{a:1}"但实际是"0x7B2261223A317D"（UTF-8 编码的十六进制 dump） - 字段非空却读到
null或空字符串
根本原因不是字符集（AL32UTF8 必须启用，但不是主因），而是驱动未启用 JSON 类型协议支持 —— 这和 Java 的 SQLType.JSON 是同一类机制，只是 .NET 实现路径不同。
OracleDataReader.GetValue() 和 GetFieldValue<t>()</t> 的正确用法
.NET 8 的 Oracle.ManagedDataAccess（≥ 23.5）已支持原生 JSON 类型识别，但需主动触发：
- ✅ 推荐：用
GetFieldValue<string>(index)</string>—— 它会自动调用驱动内建的 JSON-to-string 转换逻辑 - ✅ 可用：
GetValue(index) as string，但需判空，且不如泛型方法健壮 - ❌ 禁止：
GetString(index)、GetSqlString(index)、GetOracleClob(index)，它们不处理 JSON 类型
示例代码：
using (var cmd = conn.CreateCommand())
{
cmd.CommandText = "SELECT j FROM t WHERE id = 1";
using (var reader = cmd.ExecuteReader())
{
if (reader.Read())
{
// ✅ 正确：自动识别并转为 UTF-8 字符串
string jsonStr = reader.GetFieldValue<string>(0);
// ✅ 也可行，但需 null 检查
var obj = reader.GetValue(0);
string jsonStr2 = obj switch
{
string s => s,
Oracle.ManagedDataAccess.Types.OracleJson json => json.ToString(), // 注意：ToString() 返回标准 JSON 字符串
_ => null
};
}
}
}
MyBatis.Net / Dapper 中如何安全映射 JSON 字段
这些 ORM 默认不识别 OracleJson 类型，会跳过字段或报错。必须手动介入：
- Dapper：注册自定义类型处理器，重写
IDbExpression或使用SqlMapper.AddTypeHandler - MyBatis.Net：在
resultMap中为 JSON 列指定typeHandler="OracleJsonTypeHandler"，并实现继承BaseTypeHandler<string></string>的处理器 - EF Core：暂不原生支持 Oracle JSON 类型（截至 2026 年 9 月），必须用
HasConversion<string>()</string>+ 自定义 ValueConverter，且 Converter 内部仍要调用GetFieldValue<string>()</string>
关键点：所有自定义处理器中，读取逻辑必须统一走 GetFieldValue<string>(ordinal)</string>，不能 fallback 到 GetString。
服务端解析优先：什么时候不该在 .NET 层处理 JSON
如果只需要提取某个字段（如 $.user.id）做查询或展示，直接在 SQL 层用 JSON_VALUE 更高效：
SELECT id, JSON_VALUE(j, '$.user.name') AS name FROM t WHERE JSON_EXISTS(j, '$.status')
这样返回的就是 VARCHAR2 或 NUMBER，.NET 可直接用 GetString() 或 GetInt32()，完全避开 JSON 类型问题。
容易被忽略的地方：
- 即使用了
JSON_VALUE(... RETURNING VARCHAR2)，若路径不存在且没配DEFAULT ... ON ERROR，仍可能返回null—— 这是 SQL 行为，不是驱动问题 -
JSON_OBJECT或JSON_ARRAY的结果列仍是原生JSON类型，不能靠 SQL 转换绕过驱动限制 - AL32UTF8 字符集必须设为数据库级默认，否则中文在
ToString()后仍是???
