在 .net 8 中发布单文件应用时,odp.net 找不到依赖库是因为 oracle 的托管驱动 oracle.manageddataaccess 默认不包含非托管的原生 dll(如 oci.dll),而单文件模式会将所有程序集提取到临时目录,导致 odp.net 无法定位这些原生库。解决办法是改用包含原生库的 oracle.manageddataaccess.native nuget 包,或者在发布时配置 includenativelibrariesforselfextract 属性以强制提取这些文件。

为什么单文件模式下 ODP.NET 会报错?
这是因为 ODP.NET 的托管部分需要加载同目录下的非托管 .dll 文件,而单文件打包后这些文件被隐藏或未被正确提取。当应用程序尝试连接数据库时,CLR 会在当前执行路径下搜索 oci.dll 等文件,如果找不到就会抛出 DllNotFoundException 或 FileLoadException。

<project sdk="Microsoft.NET.Sdk"><propertygroup><outputtype>Exe</outputtype><targetframework>net8.0</targetframework><implicitusings>enable</implicitusings><nullable>enable</nullable><publishsinglefile>true</publishsinglefile><includenativelibrariesforselfextract>true</includenativelibrariesforselfextract></propertygroup><itemgroup><packagereference include="Oracle.ManagedDataAccess" version="23.5.0"></packagereference><packagereference include="Oracle.ManagedDataAccess.Native" version="23.5.0"></packagereference></itemgroup></project>
如何验证原生库是否已正确提取?
可以通过检查发布后的输出目录或运行时的临时文件夹来验证。在 Windows 上,单文件应用通常将内容提取到 %TEMP% 下的一个随机命名文件夹中。如果 IncludeNativeLibrariesForSelfExtract 设置为 true,你应该能在该临时目录下看到 win-x64 或 linux-x64 子目录,其中包含 oci.dll、oraaccess.dll 等文件。如果这些文件缺失,说明配置未生效或包引用不完整。

using System;
using System.IO;
using Oracle.ManagedDataAccess.Client;
class Program
{
static void Main()
{
// 获取当前应用程序的执行路径
string appPath = AppDomain.CurrentDomain.BaseDirectory;
Console.WriteLine($"Application Path: {appPath}");
// 检查是否存在 oci.dll
string ociDll = Path.Combine(appPath, "oci.dll");
if (File.Exists(ociDll))
{
Console.WriteLine("oci.dll found.");
}
else
{
Console.WriteLine("oci.dll NOT found. Check native library extraction.");
}
// 尝试连接(假设你有有效的连接字符串)
// var conn = new OracleConnection("User Id=scott;Password=tiger;Data Source=localhost/orclpdb1");
// conn.Open();
// Console.WriteLine("Connected successfully.");
// conn.Close();
}
}
基于 IncludeNativeLibrariesForSelfExtract 属性的具体行为问题
当 IncludeNativeLibrariesForSelfExtract 设置为 true 时,MSBuild 会在发布过程中将标记为 CopyToOutputDirectory 的原生库复制到输出目录,并在运行时自动提取它们。如果设置为 false(默认值),则不会提取这些文件,导致 ODP.NET 失败。此外,如果使用了 Oracle.ManagedDataAccess.Core 而不是 Oracle.ManagedDataAccess,则不需要此属性,因为核心版本是纯托管的,但功能可能受限。对于完整的 ODP.NET 功能,必须使用 Oracle.ManagedDataAccess 并配合 Oracle.ManagedDataAccess.Native 包以及正确的发布属性。










