优先使用Oracle官方镜像container-registry.oracle.com/database/enterprise:19.3.0.0，需先docker login该地址；挂载目录须绝对路径且chmod 777；ORACLE_PWD避免shell特殊字符，推荐纯字母数字；数据库就绪以日志“DATABASE IS READY TO USE!”为准。
能直接用官方现成镜像就别自己构建 dockerfile，除非你有合规审计或定制内核参数的硬性要求。自行构建耗时长、失败点分散，90% 的卡顿都出在权限、路径、密码解析和 ulimit 上。
拉取哪个 registry 地址才不会 403
必须用 Oracle 官方新地址：container-registry.oracle.com/database/enterprise:19.3.0.0。旧地址如 store/oracle/database:19.0.0.0 或 oracle/database:19.3.0-ee 已下线，拉取必报 403。
- 先登录：
docker login container-registry.oracle.com（账号需在 oracle.com 注册并接受许可协议） - 网络受限时可临时用阿里云镜像：
registry.cn-hangzhou.aliyuncs.com/zhuyijun/oracle:19c，但仅限开发测试，不满足等保或金融合规场景 - 别信 Docker Hub 上标着 “oracle19c” 的不明镜像，多数未更新且无签名验证
-v 挂载目录权限必须是 777 且绝对路径
Oracle 容器内以 oracle 用户运行初始化脚本，它没有 sudo 权限，也不能递归创建父目录。权限不足或路径错误会导致静默失败，日志里只显示：mkdir: cannot create directory ‘/opt/oracle/oradata’: Permission denied 或 cat: /opt/oracle/cfgtoollogs/dbca/ORCL.log: No such file or directory。
- 宿主机上必须用绝对路径创建并授权：
sudo mkdir -p /mydata/oracle/oradata && sudo chmod 777 /mydata/oracle/oradata - 挂载参数写全路径：
-v /mydata/oracle/oradata:/opt/oracle/oradata - 禁用相对路径：
./oradata、~/oradata、/home/user/oradata全部不行——哪怕后者是绝对路径，也可能因用户 umask 限制导致子目录不可写
ORACLE_PWD 环境变量不能被 shell 提前解析
看似合法的密码如 ORACLE_PWD=oracle@2026 或 ORACLE_PWD=Orcl2026!，在 bash 中会被展开：! 触发历史命令扩展，$、`、" 也会被插值，最终传进容器的密码被截断，数据库创建失败。
- 最稳做法：纯字母+数字组合，例如：
ORACLE_PWD=Orcl2026 - 若必须含特殊字符，整个值用单引号包裹：
-e 'ORACLE_PWD=oracle@2026' - 避免使用：
! @ $ % ^ & * ( ) ` " ' \ | ; : , . ? /中任意字符（即使加了引号，某些 shell 或 CI 环境仍可能二次解析）
容器启动后怎么确认数据库真就绪了
别一看到 docker ps 显示 running 就去连——Oracle 初始化要好几分钟，期间连上去会报 ORA-12514: TNS:listener does not currently know of service requested。必须等容器日志输出明确字符串：
DATABASE IS READY TO USE!
- 实时盯日志：
docker logs -f oracle19c - 看到该行后再试连接，例如：
sqlplus system/Orcl2026@//localhost:1521/ORCLPDB1 - 如果等了 10 分钟还没出现，大概率是挂载路径权限或密码问题，立刻
docker logs oracle19c | tail -50查错，别盲目重启
真正容易被忽略的是：容器启动成功 ≠ 数据库就绪。很多团队在 CI 流水线里没加就绪检查，导致后续 SQL 脚本批量失败，排查时才发现是连早了两分钟。
