docker pull oracle/database 会失败，因Oracle官方镜像不托管在Docker Hub，需从GitHub下载docker-images仓库、获取二进制包、运行./buildContainerImage.sh构建；挂载必须用绝对路径/opt/oracle/oradata并预设权限；端口映射需-p 1521:1521；首次连接须用密码文件方式，禁用OS认证。
docker pull oracle/database 报错或超时怎么办
oracle 官方镜像不托管在 docker hub，docker pull oracle/database 会失败——这是最常卡住的第一步。它只存在于 oracle 的 github 仓库和 registry（需登录），且必须手动构建。
- 必须先去 Oracle 官方 docker-images 仓库 下载对应版本的
Dockerfile和构建脚本 - 下载 Oracle Database 二进制安装包（如
linuxx64_193000_db_home.zip）并放至指定目录，否则构建直接报file not found - 构建命令不是
docker build简单执行：要运行./buildContainerImage.sh脚本，并显式指定版本和类型（如-v 19.3.0 -e表示企业版） - 国内网络大概率无法直连 Oracle 官网下载页，得提前用代理或找可信渠道获取安装包，MD5 校验必须通过，否则构建中途静默失败
挂载 /opt/oracle/oradata 为什么容器启动后数据还是丢了
挂载路径写错、权限没设对、宿主机目录未预创建，三者任一都会导致 Oracle 启动时跳过数据初始化，回退到内存模式或报 ORA-01034: ORACLE not available。
- 必须挂载到容器内确切路径：
/opt/oracle/oradata，少一个字母或大小写错误（比如/opt/oracle/oradata/多斜杠）都可能失效 - 宿主机目录需提前
mkdir -p /my/oradata，且用chown -R 54321:54321 /my/oradata（Oracle 容器默认以 UID 54321 运行） - 不能只挂载子目录（如只挂
/my/oradata/ORCLCDB），Oracle 启动时需要完整oradata结构，否则初始化失败后自动删掉已有文件 - 若用 Docker Compose，
volumes中路径必须是绝对路径，./data这类相对路径在非当前目录启动时会挂空
docker run 启动后监听不到 1521 端口
端口映射漏配、防火墙拦截、Oracle 实例未真正 open，三者常见但容易混淆。
-
docker run必须带-p 1521:1521，仅-p 1521（不指定宿主机端口）会导致随机端口映射，连不上 - 容器日志里出现
DATABASE IS READY TO USE!才算实例真正 open；如果只看到Starting tnslsnr就连，TNS 服务起来了但数据库还没启好，会报ORA-12514: TNS listener does not currently know of service requested - Linux 宿主机若开了 firewalld 或 ufw，需额外放行 1521：
sudo firewall-cmd --add-port=1521/tcp --permanent - Mac/Windows 用户注意：Docker Desktop 的网络栈不等同于 Linux，
localhost:1521在宿主机能连，但在容器内用host.docker.internal才能访问宿主机服务
首次连接 sqlplus / as sysdba 提示 ORA-01031: insufficient privileges
Oracle 容器默认禁用 OS 认证，/ as sysdba 本地免密登录不可用，必须走密码文件或网络连接。
- 容器内执行
sqlplus /nolog→connect sys/<code>ORACLE_PWD@localhost:1521/ORCLCDB as sysdba，其中ORACLE_PWD是启动时传入的环境变量值 - 若想启用 OS 认证，需在构建镜像时修改
sqlnet.ora并挂载自定义配置，但违背最小权限原则，不建议 - 连接字符串中的 service name 必须准确：
ORCLCDB（CDB）或ORCLPDB1（PDB），写成ORCL或XE会报ORA-12154: TNS could not resolve the connect identifier - 密码含特殊字符（如
@、/）时，整个密码要用单引号包裹：sys/'My@Pass!'/@...，否则 shell 解析出错
