结论：不能只装 Oracle.EntityFrameworkCore 就完事，Linux容器里缺 Oracle Instant Client 运行时，不配好就必然报 System.DllNotFoundException: libclntsh.so 或连接超时。
直接说结论：不能只装 Oracle.EntityFrameworkCore 就完事，Linux容器里缺 Oracle Instant Client 运行时，不配好就必然报 System.DllNotFoundException: libclntsh.so 或连接超时。
为什么 Oracle.ManagedDataAccess.Core 在 Linux 容器里会失败
这个包名字带 “Managed”，容易让人误以为纯托管、零依赖——但它在 Linux 上仍需底层 Oracle 客户端库（libclntsh.so）做网络协议解析和 TNS 处理。Windows 上靠 .NET Framework 自带或注册表找客户端，Linux 没这套机制，必须手动提供共享库路径。
-
Oracle.ManagedDataAccess.Core是“半托管”：C# 层逻辑是托管的，但 Oracle 网络栈（SQL*Net、加密、重连）仍调用原生libclntsh.so - Alpine 镜像默认用 musl libc，而 Oracle Instant Client 编译依赖 glibc，直接
apk add会报ERROR: unable to load shared library 'libclntsh.so' - 哪怕你用 Ubuntu/Debian 基础镜像，
apt install oracle-instantclient-basic也早已下架，官方只提供 ZIP 包分发
在 Dockerfile 中正确安装 Instant Client 的三步
必须按顺序执行，漏一步就会找不到库或版本不匹配：
- 先装系统依赖：
apt-get install -y libaio1 wget unzip（libaio1是 Oracle 客户端必需的异步 I/O 库） - 再下载并解压官方 ZIP：
wget https://download.oracle.com/otn_software/linux/instantclient/211000/instantclient-basiclite-linux.x64-21.1.0.0.0.zip，然后unzip ... -d /opt/oracle - 最后设环境变量并验证：
ENV LD_LIBRARY_PATH=/opt/oracle/instantclient_21_1:$LD_LIBRARY_PATH，并在容器启动前加一句ls -l /opt/oracle/instantclient_21_1/libclntsh.so*确认文件存在
注意：别用 23.x 版本——Oracle.EntityFrameworkCore 7.x 目前只兼容 Instant Client 19c–21c；23c 的 libclntsh.so 会触发 ORA-12154 解析失败。
appsettings.json 里写连接字符串的坑
TNS 别名（如 Data Source=ORCL）在容器里基本不可用，因为没 tnsnames.ora 文件也没 ORACLE_HOME 环境变量去定位它。必须展开成完整描述符：
{"ConnectionStrings": {
"OracleConnection": "User Id=your_user;Password=your_pass;Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=oracle-db)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCLPDB1)))"
}}
-
HOST填的是 Docker 内网服务名（如oracle-db），不是localhost——容器里localhost指自己，不是宿主机 -
SERVICE_NAME要和 Oracle 数据库实际 PDB 名一致（查SELECT NAME FROM V$SERVICES），别错写成SID - 如果 Oracle 用的是非标准端口（比如 1522），
PORT必须显式写，不能省略
EF Core 启动时最常见的两个报错及对应检查点
容器里跑起来第一眼看到的错误，大概率是下面两种之一：
-
OracleException: ORA-12154: TNS:could not resolve the connect identifier specified→ 检查连接字符串是否展开、HOST是否可 ping 通、DNS 是否在容器内生效（Docker 默认用8.8.8.8，若 Oracle 在内网 DNS 下需配--dns） -
DllNotFoundException: libclntsh.so→ 检查LD_LIBRARY_PATH是否包含解压路径、ls -l /opt/oracle/instantclient_21_1/libclntsh.so*是否输出文件、ldd /opt/oracle/instantclient_21_1/libclntsh.so是否显示所有依赖满足（尤其libaio.so.1）
真正麻烦的不是配置本身，而是这些错误信息几乎不提示具体缺哪一环——libclntsh.so 找不到时，EF Core 不会告诉你它想找的是哪个路径，只抛一个空泛异常；TNS 解析失败时，也不会告诉你它有没有读到 tnsnames.ora（其实根本没读）。得靠日志+手动验证每一步。
