64位PLSQL Developer连接数据库报错，正确的解决方法是什么？

在 64 位 Windows 操作系统上使用 64 位 PL/SQL Developer 连接 Oracle 数据库是许多开发者和数据库管理员（DBA）在日常工作中可能遇到的一个典型问题，问题的根源并非 PL/SQL Developer 本身有缺陷，而在于其软件架构与系统环境之间存在的微妙不匹配，本文将详细、系统地解析这一问题的成因，并提供一套完整、清晰的解决方案,帮助您顺利建立连接。

核心问题：架构不匹配

我们必须理解一个关键事实：尽管您可能在 64 位系统上运行着 64 位的 PL/SQL Developer 安装包，但其核心程序本体实际上是一个 32 位的应用程序，这一点至关重要,因为它决定了连接数据库时所依赖的组件类型。

数据库连接过程依赖于 Oracle 客户端，特别是其中的 Oracle Call Interface (OCI) 库，其核心文件是 oci.dll，这个动态链接库文件充当了 PL/SQL Developer 与 Oracle 数据库服务器之间的桥梁，根据 Windows 系统的运行机制，一个 32 位的应用程序（PL/SQL Developer）只能加载和调用 32 位的动态链接库（oci.dll），它无法识别或使用 64 位的 oci.dll。

当您的系统上只安装了 64 位的 Oracle 客户端或者 64 位的 Oracle 数据库软件时，PL/SQL Developer 在尝试连接时会报错，Initialization error”、“Could not resolve OCI”或“ORA-12154: TNS:could not resolve the connect identifier specified”，因为它找不到它所需要的 32 位 oci.dll 文件，即便数据库服务器本身是 64 位的，这也不影响,因为客户端连接工具的位数必须与客户端库的位数保持一致。

解决方案：安装并配置 32 位 Oracle 客户端

解决这个问题的标准且最稳妥的方法是，在您的系统中额外安装一个独立的 32 位 Oracle 客户端，并专门配置 PL/SQL Developer 使用它，Oracle Instant Client 是最理想的工具，因为它轻量、免安装,且功能齐全。

下载 32 位 Oracle Instant Client

访问 Oracle 官方网站的 Instant Client 下载页面。
在选择版本时，请务必留意平台选择，您需要选择与您 PL/SQL Developer 版本兼容的 32 位版本，选择“32-bit”或“x86”字样的版本。
下载“Basic”或“Basic Light”包即可，这个压缩包包含了连接数据库所需的核心文件，包括 oci.dll、oraociei11.dll（或对应版本的文件）等。

解压与设置

将下载的 ZIP 压缩包解压到一个路径简单且不包含中文字符或空格的目录下，C:oracleinstantclient_32，这是一个良好的实践,可以避免潜在的路径解析问题。
在该解压目录下，手动创建一个名为 tnsnames.ora 的文本文件，这个文件用于定义数据库连接的别名,简化连接字符串。
打开 tnsnames.ora 文件,按照以下格式添加您的数据库连接信息：
```
# 这是一个注释，描述这个连接的用途
ORCLDEV =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
    )
    (CONNECT_DATA =
      (SERVICE_NAME = orcl.dev.com)
    )
  )
# 另一个连接示例
PROD_DB =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = prod-db-srv.mycompany.com)(PORT = 1521))
    (CONNECT_DATA =
      (SID = PROD)
    )
  )
```
- ORCLDEV, PROD_DB 是您自定义的连接别名。
- HOST 是数据库服务器的 IP 地址或域名。
- PORT 是数据库监听的端口号，默认为 1521。
- SERVICE_NAME 或 SID 是数据库实例的服务名或 SID，请向您的 DBA 确认具体值。

配置 Windows 系统环境变量

为了让系统和 PL/SQL Developer 能够找到 32 位的 Instant Client 文件,需要配置两个重要的系统环境变量。

右键点击“此电脑”->“属性”->“高级系统设置”->“环境变量”。
在“系统变量”区域，进行以下操作：
- 新建变量 TNS_ADMIN：
  - 变量名：TNS_ADMIN
  - 变量值：填写您的 tnsnames.ora 文件所在的目录，即 C:oracleinstantclient_32，这个变量会告诉 Oracle 客户端工具去哪里寻找网络配置文件。
- 编辑变量 Path：
  - 找到并选中 Path 变量，点击“编辑”。
  - 点击“新建”，将 32 位 Instant Client 的路径 C:oracleinstantclient_32 添加进去，为了确保优先使用此路径下的 oci.dll,建议将其移动到列表的顶端。

配置完成后，重启 PL/SQL Developer 或任何新打开的命令行窗口,以使环境变量生效。

在 PL/SQL Developer 中配置连接

我们需要在 PL/SQL Developer 内部指定使用我们刚刚配置好的 32 位客户端。

打开 PL/SQL Developer,但不要登录。
进入顶部菜单栏的 工具 -> 首选项。
在弹出的窗口左侧，找到并点击 Oracle -> 连接。
在右侧的配置界面中，找到 Oracle 主目录 或 Oracle Home 字段。
点击输入框右侧的浏览按钮，或者直接手动输入您 32 位 Instant Client 的路径，C:oracleinstantclient_32。
设置完成后，OCI 库 或 OCI Library 字段通常会自动填充为 C:oracleinstantclient_32oci.dll，如果没有,请手动浏览并选择该文件。
点击“应用”和“确定”保存设置。

创建并测试数据库连接

所有配置工作已就绪,现在是时候验证成果了。

回到 PL/SQL Developer 的登录窗口。
在“用户名”处输入您的数据库用户名。
在“密码”处输入对应的密码。
在“数据库”处，输入您在 tnsnames.ora 文件中定义的连接别名，ORCLDEV。
点击“连接”按钮。

如果一切配置正确，PL/SQL Developer 将会成功加载 32 位的 oci.dll，通过 tnsnames.ora 解析别名，并最终连接到目标 Oracle 数据库，您将看到主界面成功加载,可以开始您的工作了。

小编总结与要点回顾

解决 64 位 PL/SQL Developer 连接数据库问题的关键，在于理解其 32 位应用程序的本质，并为它提供一个匹配的 32 位 Oracle 客户端环境,整个过程可以概括为以下几个核心步骤：

明确需求：认识到必须使用 32 位客户端。
获取工具：下载官方 32 位 Oracle Instant Client。
本地配置：解压客户端，创建并配置 tnsnames.ora 文件。
系统级关联：设置 TNS_ADMIN 和 PATH 环境变量。
应用内指定：在 PL/SQL Developer 的首选项中明确指定 32 位客户端的 Oracle Home 路径。
最终连接：使用 tnsnames.ora 中定义的别名进行登录。

遵循以上步骤，您就能够稳定、可靠地在 64 位系统上使用 PL/SQL Developer 进行数据库开发与管理。

64位PLSQL Developer连接数据库报错，正确的解决方法是什么？

核心问题：架构不匹配