ORA-12154 TNS错误：K8s部署的.Net Core API连接Oracle报错如何解决？

• 验证容器内实际生效的连接串配置
  进入运行中的Pod执行命令kubectl exec -it <目标Pod名称> -- cat /app/appsettings.json，直接查看文件内的Oracle连接串配置是否符合预期。同时可以新增临时调试接口打印程序加载的连接串，确认没有被.NET Core更高优先级的配置源（比如K8s注入的环境变量、ConfigMap/Secret挂载覆盖）修改。
• 检查连接串格式是否符合Oracle要求
  • 若使用TNS别名格式连接：确认容器内是否存在tnsnames.ora文件，且文件路径在Oracle客户端可识别的network/admin目录下（通常为/usr/lib/oracle/<客户端版本号>/client64/network/admin/），同时连接串中填写的别名要和tnsnames.ora内的条目完全匹配，大小写、特殊符号均不能有差异。
  • 若使用EZCONNECT直连格式：确认格式书写正确，使用服务名的格式为Data Source=//<数据库IP>:<端口>/<服务名>;User Id=<用户名>;Password=<密码>，使用SID的格式为Data Source=<数据库IP>:<端口>:<SID>;User Id=<用户名>;Password=<密码>，不要混淆SID和服务名。
• 测试Pod到Oracle数据库的网络连通性
  进入Pod执行命令nc -zv <数据库IP> <数据库端口>（默认端口为1521），确认网络可达。K8s集群的网络策略、节点出口防火墙、数据库端的访问控制列表都可能拦截流量，网络不通也会触发ORA-12154错误。
• 验证Oracle客户端版本兼容性
  确认容器内安装的Oracle Instant Client大版本和数据库服务端版本兼容，跨度过大的版本差异可能导致TNS解析异常。

• 优先使用EZCONNECT直连格式
  不需要依赖tnsnames.ora文件，无需额外修改镜像内容，连接串示例如下：

  "ConnectionStrings": {
    "OracleDb": "Data Source=//192.168.1.20:1521/ORCLPDB1;User Id=appuser;Password=App@2024;"
  }
  

• 必须使用TNS别名的场景
  可以选择将tnsnames.ora打入镜像，在Dockerfile中新增配置：

  COPY ./tnsnames.ora /usr/lib/oracle/21/client64/network/admin/
  

  也可以将tnsnames.ora内容存入K8s ConfigMap，挂载到Pod的对应network/admin目录，方便后续修改TNS配置无需重新构建镜像。
• 配置被覆盖的场景
  调整.NET Core配置加载优先级，在Program.cs中将appsettings配置源的优先级调整到环境变量之前，或者重命名冲突的环境变量键名。
• 网络不通的场景
  排查K8s网络策略、节点安全组、数据库访问控制列表，放开Pod所在网段访问数据库端口的权限。

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