挂载路径、宿主机目录权限、初始化等待时间及密码策略四者必须全部正确：路径需匹配镜像默认数据目录（如helowin为/home/oracle/app/oracle/oradata/helowin），权限须为uid/gid 500:500，启动后需等待日志出现就绪提示再连接，并首次连入后执行alter profile default limit password_life_time unlimited。
挂载路径必须匹配容器内Oracle数据目录
Oracle镜像启动后，数据默认写入容器内部路径，比如 /u01/app/oracle（sath89/oracle-12c）、/home/oracle/app/oracle/oradata/helowin（helowin/oracle_11g）或 /opt/oracle/oradata（Oracle官方21c镜像）。如果挂载点路径不一致，Docker会创建空目录覆盖原有数据，导致初始化失败或连接报 ORA-01034: ORACLE not available。
实操建议：
- 先运行一次临时容器，用
docker exec -it ls -l确认真实路径 - 对 helowin 镜像，必须挂载到
/home/oracle/app/oracle/oradata/helowin，不能只挂到/home/oracle/app/oracle/oradata - 对 sath89/oracle-12c，挂载点应为
/u01/app/oracle，因为其初始化脚本硬编码了该路径 - Oracle官方21c镜像要求挂载到
/opt/oracle/oradata，且需提前用docker volume create oracle_data创建命名卷更稳妥
宿主机目录权限必须匹配容器内oracle用户UID/GID
Oracle进程在容器内以 UID=500、GID=500 的 oracle 用户身份运行。若宿主机挂载目录属主不是 500:500，容器启动时会因权限不足无法读写数据文件，日志中反复出现 chown: changing ownership of '/u01/app/oracle': Operation not permitted 或直接卡在 “Initializing database…” 阶段。
实操建议：
- 创建挂载目录后立即执行：
sudo chown -R 500:500 /your/local/oradata - 不要用
root:root或当前用户属主，即使加了--privileged也无效 - 使用命名卷（
docker volume create）可规避此问题，但需确认镜像支持——sath89 和官方21c支持，helowin 不支持
首次启动必须等待数据库初始化完成
Oracle容器启动不等于数据库就绪。从 docker run 返回容器ID，到能用 sqlplus system/oracle@localhost:1521/XE 连上，通常需 5–12 分钟。期间 docker logs -f 会持续输出初始化日志，关键标志是出现 Database ready to use（sath89）、ORACLE DATABASE IS READY TO USE!（官方21c）或 Database opened.（helowin）。在此之前强行连接，只会得到 ORA-12514: TNS listener does not currently know of service requested。
实操建议：
- 不要依赖容器状态为
Up X seconds就认为可用 - 可在启动后加简单轮询：
while ! sqlplus -s /nolog /dev/null 2>&1; connect system/oracle@localhost:1521/XE; exit; EOF; do sleep 10; done - 若超过15分钟仍无就绪提示，检查挂载路径和权限——90% 的“启动卡住”问题出在这两处
密码过期策略必须在首次连接后立即禁用
Oracle默认 DEFAULT profile 设置 PASSWORD_LIFE_TIME 为 180 天。容器重启后若未提前处理，system/sys 用户可能已锁定，连接时抛出 ORA-28000: the account is locked。这不是网络或挂载问题，而是数据库内部状态。
实操建议：
- 首次连上后立刻执行：
ALTER PROFILE DEFAULT LIMIT PASSWORD_LIFE_TIME UNLIMITED; - 解锁账户（如已锁）：
ALTER USER SYSTEM ACCOUNT UNLOCK;和ALTER USER SYS ACCOUNT UNLOCK; - 不要仅改密码（
ALTER USER SYSTEM IDENTIFIED BY xxx;），不解锁+不限期，下次重启照旧锁 - 该操作只需做一次，持久化卷会保存 profile 修改结果
