如何使用Docker Compose部署Oracle 21c-Oracle-PHP中文网

可行但需严格遵循配置要求：必须使用命名卷、设置oracle_password强密码、指定uid 54321可写路径、配置600s启动等待期及健康检查，否则初始化失败或监听未就绪。

如何使用docker compose部署oracle 21c

直接用 docker-compose 部署 Oracle 21c 是可行的，但官方镜像不原生支持 Compose 启动方式——它依赖环境变量初始化、固定 UID/GID 和特定挂载路径，稍有偏差就会卡在 “DATABASE IS READY TO USE!” 之前或根本无法启动。

为什么不能直接写个简单 docker-compose.yml 就跑起来

Oracle 官方镜像（container-registry.oracle.com/database/express:21.3.0-xe 或 enterprise:21.3.0.0）在启动时会执行初始化脚本，该脚本严格检查：

ORACLE_PASSWORD 必须非空且满足复杂度（至少 8 字符，含大小写字母+数字+特殊符号）
/opt/oracle/oradata 挂载点目录必须可被 UID 54321 写入（不是靠 chmod 777 就能绕过）
容器内进程以用户 oracle（UID=54321）运行，宿主机挂载卷若权限不足，初始化直接失败并退出
镜像不接受 command 覆盖，强行指定 entrypoint 会导致初始化逻辑跳过

docker-compose.yml 必须包含的关键配置项

以下是最小可用模板（适用于 Express 版），注意每项都不可省略或随意改动：

Docker Cli

使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载

version: '3.8'
services:
  oracle-db:
    image: container-registry.oracle.com/database/express:21.3.0-xe
    container_name: oracle-db
    restart: unless-stopped
    environment:
      - ORACLE_PASSWORD=MyStrongP@ssw0rd21c
      - ORACLE_CHARACTERSET=AL32UTF8
      - TZ=Asia/Shanghai
    ports:
      - "1521:1521"
      - "5500:5500"
    volumes:
      - oracle-data:/opt/oracle/oradata
      # 注意：不要用 ./oradata 这种相对路径，Docker Desktop on Mac/Windows 有权限映射 bug
    healthcheck:
      test: ["CMD-SHELL", "sqlplus -s /nolog volumes:
oracle-data:

关键点说明：

volumes 必须声明为 named volume（如 oracle-data），而非 bind mount；否则宿主机目录权限无法自动适配 UID 54321
healthcheck 中的 start_period: 600s 是必须的——Oracle 初始化耗时常超 5 分钟，不设这个会导致 Compose 误判为失败并反复重启
TZ 环境变量建议显式设置，否则容器内时间可能与客户端时区错位，影响日志和调度
不要加 privileged: true ——Oracle 镜像不需要特权模式，加了反而可能触发 SELinux 拒绝

启动后连不上？先查这三件事

常见连不上现象：ORA-12541: TNS:no listener、ORA-12170: TNS:Connect timeout、EM Express 打不开（5500 端口返回 404）。

执行 docker logs oracle-db --tail 50，确认最后一行是否为 DATABASE IS READY TO USE!；没看到就说明初始化失败，重点看前面报错里有没有 permission denied 或 ORA-01034
执行 docker exec -it oracle-db id，确认输出是 uid=54321(oracle) gid=54321(oinstall)；如果不是，说明镜像启动时跳过了用户切换逻辑（通常因环境变量缺失）
执行 docker exec -it oracle-db lsnrctl status，看监听器是否在运行；若提示 LSNRCTL for Linux: Version 21.0.0.0.0... 但后面没服务列表，说明 PDB 没 open，需进 SQL*Plus 执行 alter pluggable database orclpdb open;