为什么.NET 8发布单文件应用时ODP.NET会找不到依赖库?

落枫吖_3467

落枫吖_3467

2026-11-17

177人浏览

原创

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

为什么.NET 8发布单文件应用时ODP.NET会找不到依赖库?

为什么单文件模式下 ODP.NET 会报错?

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

为什么.NET 8发布单文件应用时ODP.NET会找不到依赖库?

<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 等文件。如果这些文件缺失,说明配置未生效或包引用不完整。

为什么.NET 8发布单文件应用时ODP.NET会找不到依赖库?

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 包以及正确的发布属性。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
oracle清空表数据
oracle清空表数据

当表中的数据不需要时,则应该删除该数据并释放所占用的空间。本专题为大家提供oracle清空表数据的相关文章,帮助大家解决该问题。

2023.08.16

1181

5

Oracle中declare的使用
Oracle中declare的使用

Oracle DECLARE语句是PL/SQL编程语言中用于声明变量、常量、游标或异常的关键字。它的主要作用是在程序中定义这些对象,以便在后续的代码中使用。DECLARE语句的语法简单明了,可以根据需要声明多个对象。通过使用这些声明的对象,可以进行各种操作,如计算、查询数据库、处理异常等 。

2023.09.15

3513

5

oracle怎么分页
oracle怎么分页

实现分页的步骤:1、使用ROWNUM进行分页查询;2、在执行查询之前进行设置分页参数;3、使用"COUNT(*)"函数来获取总行数,并使用"CEIL"函数来向上取整计算总页数;4、在外部查询中使用"WHERE"子句来筛选出特定的行号范围,以实现分页查询。想了解更多oracle怎么分页的文章,可以来阅读本专题先的文章。

2023.09.18

3530

5

Oracle查看表操作历史记录
Oracle查看表操作历史记录

查看操作历史记录的方法:1、使用Oracle内置的审计功能,可以记录数据库中发生的各种操作,包括登录、DDL语句、DML语句等;2、使用Oracle日志文件,其中包含了数据库中发生的各种操作,可以通过查看日志文件来获取操作历史记录;3、使用Oracle的Flashback功能,可以查看数据库在某个时间点的操作历史记录;4、使用第三方工具等。本专题还提供其他查看表操作的文章,大家可以免费阅读。

2023.09.19

2009

3

Oracle中RAC的用法
Oracle中RAC的用法

Oracle中RAC的用法:1、通过在多个服务器上运行数据库实例来提供高可用性;2、允许在需要时增加或减少节点数量;3、通过将工作负载分布到多个节点上来实现负载均衡;4、使用共享存储来实现多个节点之间的数据共享;5、允许多个节点同时处理数据库请求,从而实现并行处理;6、提供了透明故障切换功能;7、使用了一些技术来确保数据的一致性;8、提供了管理工具来简化RAC环境的管理和维护。本专题还提供RAC相关的其他文章,大家可以免费阅读。

2023.09.19

2613

7

oracle imp
oracle imp

imp是Oracle数据库中的一个命令行工具,用于将导出的数据和对象从一个数据库实例导入到另一个数据库实例。imp命令的一般语法为“imp username/password@connect_string file=file_name [options]”。

2023.09.19

3689

4

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

5009

19

oracle通配符有哪些
oracle通配符有哪些

oracle通配符有“%”、“_”、“[]”和“[^]"。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.08

257

5

oracle四舍五入怎么操作
oracle四舍五入怎么操作

oracle四舍五入操作可以使用ROUND函数来实现,其语法为“ROUND(number, decimal_places)”,其中,number是要进行四舍五入的数值,decimal_places是指定的小数位数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.14

966

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习