如何在.NET Core中通过Code First方式向Oracle 19c数据库存入图片

前提依赖 #

• 必须使用Oracle官方EF驱动：非Core版本用Oracle.ManagedDataAccess.EntityFramework，Core版本用Oracle.EntityFrameworkCore，确保驱动版本和你的EF版本、Oracle 19c兼容，优先使用最新稳定版。

正确配置步骤 #

1. 模型属性无需冗余注解，直接定义为字节数组即可：

// SecUser模型类中定义
public byte[] Signature { get; set; }

2. Fluent API配置（在OnModelCreating方法中编写），显式指定字段类型和长度，避免驱动识别为RAW类型触发4000字节限制：

builder.Entity<SecUser>()
    .Property(p => p.Signature)
    .HasColumnType("BLOB") // 与Oracle字段类型保持一致，大写匹配Oracle默认命名规则
    .HasMaxLength(int.MaxValue) // 显式标记为大长度二进制，驱动会自动按BLOB逻辑处理
    .IsRequired(false); // 可根据业务需求调整是否允许为空

3. 全局Oracle驱动配置（必须配置，解决默认参数绑定限制问题）：

• 如果是.NET Core/.NET 5+版本，在程序启动入口（Program.cs）注册DbContext之前添加以下配置：

Oracle.ManagedDataAccess.Client.OracleConfiguration.BindByName = true;
Oracle.ManagedDataAccess.Client.OracleConfiguration.InitialLONGFetchSize = -1;

• 如果是.NET Framework版本，在App.config/Web.config的配置节点中添加：

<oracle.manageddataaccess.client>
  <settings>
    <setting name="BindByName" value="true" />
    <setting name="InitialLONGFetchSize" value="-1" />
  </settings>
</oracle.manageddataaccess.client>

错误配置踩坑说明 #

• 不要将BLOB字段映射为string类型，二进制数据转字符串会出现编码丢失问题，也不符合Oracle字段类型设计逻辑
• 不要使用image作为字段类型，该类型是SQL Server专有类型，Oracle 19c不识别
• 不要省略HasMaxLength(int.MaxValue)配置，默认情况下驱动会将长度小于4000的二进制映射为RAW类型，超过4000字节就会触发ORA-01460转换错误

内容的提问来源于stack exchange，提问作者CoderStartup