Oracle健康检查需用AspNetCore.HealthChecks.Oracle包，连接字符串须为TNS或Easy Connect格式，且必须先注册DbContext；超时应设为5秒并自定义ResponseWriter透出OracleException详情，Kubernetes/Consul对接需配置ResultStatusCodes确保Unhealthy返回503。
Oracle 连接字符串配置错误导致 AddOracle 失败
直接调用 addoracle 时最常见的问题是连接字符串格式不兼容。.net core 健康检查官方包（microsoft.extensions.diagnostics.healthchecks.entityframeworkcore）本身不支持 oracle；必须使用第三方扩展包，例如 aspnetcore.healthchecks.oracle（由 xabaril 团队维护）。该包底层依赖 oracle 官方的 oracle.manageddataaccess.core，所以连接字符串必须符合其要求：不能含 data source= 或 server=，而应使用 tns 格式或简化的 easy connect 字符串。
- ✅ 正确示例：
"User Id=myuser;Password=mypass;Data Source=localhost:1521/XE" - ❌ 错误示例：
"Server=localhost;Port=1521;Database=XE;..."（这是 SQL Server 风格，Oracle 会抛出OracleException: ORA-12154） - 务必确认已安装
Oracle.ManagedDataAccess.Core≥ 3.21.130，否则AddOracle在运行时可能静默跳过注册
AddOracle 必须配合 DbContext 注册才能生效
AddOracle 不是独立工作的——它本质是为一个已注册的 DbContext 类型添加健康检查逻辑。如果你只调用 AddOracle("connstr") 却没把对应的 DbContext 注入容器，健康检查端点会返回 200 但状态始终是 Unknown，且日志中无报错。
- 先确保
services.AddDbContext<myoraclecontext>(...)</myoraclecontext>已执行 - 再调用
services.AddHealthChecks().AddOracle<myoraclecontext>("connstr", name: "oracle-db")</myoraclecontext> - 若使用多个 Oracle 实例，每个需指定唯一
name，否则后注册的会覆盖前一个 - 不建议在
AddOracle中传入空或 null 连接字符串——它不会抛异常，但会在请求时返回Unhealthy并附带NullReferenceException堆栈（实际发生在内部OracleConnection构造阶段）
自定义超时与失败响应需通过 HealthCheckOptions
Oracle 网络波动常见，默认 30 秒超时太长，容易拖慢整个健康检查端点响应。同时，原生返回的 JSON 不含具体错误原因（比如是连接拒绝还是认证失败），不利于运维排查。
- 在
UseHealthChecks时传入new HealthCheckOptions，设置Timeout = TimeSpan.FromSeconds(5) - 用
ResponseWriter替换默认输出，手动序列化context.Registration.FailureStatus和result.Exception?.Message - 注意：Oracle 连接失败时抛出的异常类型多为
OracleException，其Number属性可区分场景（如 12170=超时，1017=用户名密码错误），可在自定义 writer 中提取并透出
Consul 或 Kubernetes 探针对接时要注意 HTTP 状态码语义
Kubernetes 的 livenessProbe 默认将非 200 视为失败，但 .NET Health Checks 默认对 Unhealthy 返回 503，对 Degraded 返回 200 —— 这会导致 Oracle 不可用时容器仍被判定为“存活”，从而无法触发重启。
- 在
HealthCheckOptions中显式设置ResultStatusCodes： ResultStatusCodes = new Dictionary<healthstatus int> { [HealthStatus.Unhealthy] = StatusCodes.Status503ServiceUnavailable }</healthstatus>- Consul 的
HTTP检查同样依赖状态码，若配了timeout=5s但健康端点因 Oracle 阻塞 10 秒，Consul 会标记为 critical 并注销服务——此时必须确保AddOracle的超时 ≤ Consul 的timeout
SELECT 1 FROM DUAL，只检测连接建立成功与否。如果 DBA 收紧了账号权限，健康检查可能显示 Healthy，但后续业务查询仍失败。真要覆盖这一层，得写自定义 IHealthCheck 并显式执行轻量 SQL。 
