Oracle ORDS 22.1在Windows 10 CMD下安装失败问题求助

问题根源 #

ORDS 22.1及后续版本已弃用java -jar ords.war的执行方式，官方将核心功能迁移到了独立的ords命令行工具，你看到的"系统不再支持该命令"提示属于版本迭代后的正常要求。

完整安装与配置流程 #

1. 前置环境检查 #

• 确保已安装Java 11或更高版本（ORDS 22.1最低依赖Java 11），在CMD中执行java -version验证版本是否符合要求。
• 下载Oracle官方提供的ORDS 22.1压缩包（需下载完整ZIP包，不要单独获取war文件）。

2. 解压与环境变量配置 #

• 将ORDS压缩包解压到无空格、无特殊字符的固定目录，例如C:\ords\22.1。
• 配置系统环境变量：
  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
  2. 在「系统变量」区域点击「新建」，变量名设为ORDS_HOME，变量值填写解压路径（如C:\ords\22.1）。
  3. 找到系统变量中的Path，点击「编辑」，添加%ORDS_HOME%\bin到变量值列表。
• 必须重启CMD窗口，使新的环境变量生效，执行ords --version验证：若能显示ORDS版本号，说明PATH配置成功。

3. 初始化ORDS配置 #

在CMD中执行以下命令，按引导完成配置（替换为你的数据库实际信息）：

ords install

配置过程需提供：

• 数据库连接字符串（示例：localhost:1521/ORCLPDB1）
• SYS用户密码（用于配置ORDS所需的数据库权限）
• 选择是否启用REST服务、SQL Developer Web等功能
• 设置ORDS服务端口（默认8080）

4. 启动ORDS #

配置完成后，执行以下命令启动服务：

ords serve

启动成功后，访问http://localhost:8080/ords即可验证服务状态。

常见问题排查 #

• 若ords命令提示「不是内部或外部命令」：
  • 确认%ORDS_HOME%\bin已添加到PATH，且重启了CMD窗口。
  • 检查ORDS解压目录的bin文件夹中是否存在ords.bat脚本，若缺失则重新下载并解压完整压缩包。
• 若初始化时数据库连接失败：
  • 确认数据库服务已启动，端口、PDB名称输入正确。
  • 验证SYS用户权限，或尝试使用SYSTEM用户完成配置。

内容的提问来源于stack exchange，提问作者Xinyang Feng