ASP.NET Core 8应用开发连Oracle正常，部署至Windows Server 2022后连接失败求助

环境与背景 #

• 基于.NET 8.0的ASP.NET Core Web应用
• 使用Oracle.ManagedDataAccess.Core 23.6.1和Oracle.EntityFrameworkCore 8.23.60连接Oracle云数据库
• 开发环境（Windows 10 + Visual Studio 2022）连接正常，但发布至生产服务器（Windows Server 2022 Datacenter）后连接失败
• 采用Oracle钱包进行身份验证

已完成的排查步骤 #

• 确认appsettings.json、sqlnet.ora和ojdbc.properties配置完全正确
• 通过Test-NetConnection -ComputerName "adb.***-***-***.oraclecloud.com" -Port 1522验证服务器可正常访问Oracle数据库端口
• 检查Google Cloud Console防火墙规则，确认端口开放

遇到的错误 #

前端返回：Failed to load resource: the server responded with a status of 500 (Internal Server Error)
IIS日志未提供额外错误细节

问题 #

1. 还有哪些排查步骤可以定位连接失败的原因？
2. IIS部署环境下连接Oracle有哪些特定要求？

配置与代码 #

连接字符串 #

"OracleConnection": "User Id=******D; Password=********; Data Source=(description=(retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-chicago-1.oraclecloud.com))(connect_data=(service_name=***************_cpsprodapex_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)(my_wallet_directory=C:\\CPSPMOReporting\\wwwroot\\oracle)));",

控制器代码 #

[HttpGet]
public async Task<IActionResult> Get(DataSourceLoadOptions loadOptions) {
    var cps_fiss_sop_t = _context.CPS_FISS_SOP_T.Select(i => new {
        i.SOP_ID,
        i.SOP_NUMBER,
        i.SOP_TITLE,
        i.SOP_PURPOSE,
        i.LAST_REVISE_DATE,
        i.AREA_OWNER,
        i.LINK_ENGLISH,
        i.LINK_TRAINING,
        i.ENABLED_FLAG,
        i.DEPARTMENT,
        i.CATEGORY,
        i.CATE
    });

    // If underlying data is a large SQL table, specify PrimaryKey and PaginateViaPrimaryKey.
    // This can make SQL execution plans more efficient.
    // For more detailed information, please refer to this discussion: https://github.com/DevExpress/DevExtreme.AspNet.Data/issues/336.
    // loadOptions.PrimaryKey = new[] { "SOP_ID" };
    // loadOptions.PaginateViaPrimaryKey = true;

    return Json(await DataSourceLoader.LoadAsync(cps_fiss_sop_t, loadOptions));
}

排查建议与IIS特定要求 #

一、进一步排查步骤 #

1. 启用应用详细日志

   • 在appsettings.json中配置日志级别为Debug或Trace，记录EF Core和Oracle驱动的详细错误信息：

     "Logging": {
       "LogLevel": {
         "Default": "Debug",
         "Microsoft.EntityFrameworkCore": "Debug",
         "Oracle.ManagedDataAccess.Core": "Debug"
       }
     }
     

   • 部署后查看应用日志文件（通常在logs目录或IIS日志目录下），获取具体的连接异常堆栈信息。

2. 验证Oracle钱包权限

   • 确认IIS应用池身份（默认是AppPoolIdentity）对钱包目录C:\\CPSPMOReporting\\wwwroot\\oracle有读取权限，包括钱包文件（cwallet.sso、ewallet.p12等）。
   • 可临时将应用池身份改为具有管理员权限的账户测试，排除权限问题。

3. 测试基础数据库连接

   • 在服务器上创建一个简单的控制台应用，使用相同的连接字符串和Oracle驱动版本测试连接，看是否能成功连接并执行查询。如果控制台也失败，说明问题出在服务器环境而非IIS配置。

4. 检查Oracle驱动依赖

   • 确认服务器上已安装.NET 8.0运行时（ASP.NET Core Hosting Bundle），且版本与开发环境一致。
   • 检查发布包中是否包含Oracle.ManagedDataAccess.Core和Oracle.EntityFrameworkCore的所有依赖文件，避免缺失必要的DLL。

5. 验证SSL证书信任

   • Oracle云数据库的SSL证书可能需要被服务器信任。可以将Oracle根证书导入服务器的本地计算机信任存储，或者在sqlnet.ora中配置SSL_SERVER_CERT_DN指定证书DN，避免证书验证失败。

6. 检查连接字符串中的路径

   • 确认my_wallet_directory路径在服务器上确实存在，路径分隔符使用双反斜杠或正斜杠，避免转义错误。可尝试使用相对路径测试（相对于应用根目录）。

二、IIS连接Oracle的特定要求 #

1. 应用池身份权限

   • IIS应用池身份需要具备Oracle钱包目录的读取权限，以及访问Oracle数据库网络端口的权限。
   • 若使用AppPoolIdentity，需在钱包目录的安全设置中添加IIS AppPool\<你的应用池名称>账户并授予读取权限。

2. 32位/64位兼容性

   • 确认Oracle驱动版本与服务器操作系统位数匹配（64位服务器需使用64位驱动），同时IIS应用池的“启用32位应用程序”设置需与驱动位数一致（通常保持默认禁用，使用64位）。

3. 环境变量配置

   • 若依赖ORACLE_HOME或TNS_ADMIN环境变量，需在服务器系统环境变量中配置，或者在IIS应用池的“环境变量”中添加对应项。

4. ASP.NET Core托管模式

   • 若使用进程内托管（InProcess），需确保应用池的.NET CLR版本设置为“无托管代码”，这是ASP.NET Core应用的要求。

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