企业官网建设流程全解析

简介：ODAC1120320Xcopy_x64 是面向64位环境打包的 Oracle Data Access Components 11.2.0.3.20 组件集，主要服务于需要在 SQL Server 中创建链接服务器、跨库查询与写入 Oracle 数据的开发者和运维人员，也适合 ASP.NET/.NET 应用接入 Oracle 11g。压缩包共 194 个文件、约 54.16MB，以 90 个 dll 运行库、42 个 sql 脚本、17 个 plb 与 12 个 sym 支持文件为主，并配有 9 个 exe、7 个 config、6 个 htm 说明及 5 个 bat 配置/安装脚本，兼顾部署、注册与卸载清理。已有 9199 人学习下载，说明其在 SQL Server 与 Oracle 互通场景中具有一定参考价值。包内整合 Instant Client 11.2、OLE DB 提供程序及 ASP.NET 相关支持，读者可据此搭建链接服务器、验证跨库增删改查，并借助说明文档与配置脚本完成环境注册和故障排查。

1. 一处配置遗漏，让 ODAC1120320Xcopy_x64 在 64 位机器上也启动失败

某开发者把一套 .NET 报表服务搬到一台干净的 64 位 Windows 机器上，数据库侧是 Oracle，本机只需 ODP.NET 能连上就行。他下载 ODAC1120320Xcopy_x64，解压后依次点击 install.bat 中的步骤，看到完成提示便以为装好了。结果服务一启动就报An attempt was made to load a program with an incorrect format——他以为装了 x64 版就必然能运行，却忽略了 IIS 应用池默认开启 32 位兼容模式。

免安装的 ODAC 只是把「复制文件」这一步简化了，剩下的 GAC 注册、machine.config 配置、环境变量、进程位数对齐，都需要手动完成。只要有一项不对，就会变成难以定位的报错：错误信息不指向根因，日志只提示「加载失败」。这篇记录的是我在 64 位 Windows + .NET Framework 4.x 环境里，把 ODAC 11.2.0.3.20 xcopy 版安装并跑通、后续还能干净回滚的完整过程，适合需要在一台机器上并存多个 Oracle 版本、或者不想让 Oracle 安装器改动系统的开发者。

2. 装前先理清组件：ODAC 11.2.0.3.20 xcopy 包里到底有什么

2.1 五个组件和它们各自的产物文件

解压ODAC1120320Xcopy_x64.zip，顶层并不会出现一个 setup.exe，直接看到的是几个按组件划分的目录，加上install.bat、configure.bat、uninstall.bat三个批处理。很多人第一次打开会困惑：这些目录该不该全部复制进项目？答案是先看清各自的职责，再决定要哪几个。

最容易忽略的是最后一行。ODP.NET 和 OraOLEDB 都依赖oci.dll这一层原生调用，PATH 里没有指向<ORACLE_HOME>\bin，就会出现「程序集加载成功、一 Open 就崩」的状况。反过来，只要oci.dll的位数是对上的，前面几个组件基本不会出问题。

注意，ODP.NET 的两个目录不是版本号大小之分，而是编译目标框架不同。2.x那个只能被 .NET 2.0/3.5 的运行时加载，4那个面向 .NET 4.x。把 2.x 的 DLL 丢给一个 .NET 4 应用，会出现类型加载失败，但错误信息通常含糊，说「无法加载文件或程序集」。

2.2 位数的判断要细到进程，不是操作系统

这台机器是 64 位 Windows，不代表跑你代码的进程是 64 位。常见的三类宿主：

• IIS 的w3wp.exe：应用池设置里「启用 32 位应用程序」为 True 时，跑的是 32 位工作进程，即使系统是 64 位。
• Windows 服务：取决于编译时的/platform参数，AnyCPU在 64 位系统上默认跑 64 位，但Prefer 32-bit选项会让它变 32 位。
• 控制台调试程序：取决于你用的编译器路径，Framework\v4.0.30319\csc.exe是 32 位，Framework64\v4.0.30319\csc.exe是 64 位。

我一般用一条命令确认正在跑的那个进程：

:: 看进程路径，Framework64 下的是 64 位宿主 wmic process where "name='w3wp.exe'" get ProcessId,ExecutablePath,CommandLine

输出里C:\Windows\System32\inetsrv\w3wp.exe是 64 位；如果是C:\Windows\SysWOW64\inetsrv\w3wp.exe，那就是 32 位。这个判断错了，后面所有配置都白做。x64 的 ODAC 包只能被 64 位进程加载，32 位进程必须换成 32 位包，两者不能混装在同一个应用里。

2.3 清理旧环境：GAC 和 machine.config 先备份

xcopy 版最容易被忽略的一步，是安装之前先看机器上有没有别的 Oracle 组件。残留的Oracle.DataAccess.dll在 GAC 里，新版本装进去也不会覆盖旧的强名称，运行时按版本号匹配，可能加载到老的那份。

:: 列出 GAC 中所有 Oracle.DataAccess，注意看 Version 和 PublicKeyToken gacutil /l Oracle.DataAccess | findstr /i "Version PublicKeyToken"

如果输出里已经有 2.111.x 或 2.112.x 的旧记录，先记下完整强名称，后面决定是保留共存还是卸载。同时把两个位置的 machine.config 备份一份，这是唯一的恢复手段：

:: 64 位和 32 位各一份，改之前必须备份 copy "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\machine.config" "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\machine.config.bak" copy "C:\Windows\Microsoft.NET\Framework\v4.0.30319\Config\machine.config" "C:\Windows\Microsoft.NET\Framework\v4.0.30319\Config\machine.config.bak"

用 .NET 2.0/3.5 的项目还要额外备份v2.0.50727\Config\machine.config。这三份文件在 ODAC 安装过程中都会被写入<system.data><DbProviderFactories>节点，写坏了之后，任何依赖DbProviderFactories.GetFactory()的代码都会抛配置异常，而且这种异常与数据库完全无关，非常难往 Oracle 方向想。备份做完，后面的操作才有回退余地。

3. 解压与注册：把目录挂进系统的四步

3.1 在管理员命令行里执行 install.bat

不要双击。install.bat需要写注册表、写 GAC、改 machine.config，没有管理员权限会执行到一半失败，而且失败点不明确——前半段复制文件成功了，后半段注册失败，目录看着是完整的。

:: 管理员身份打开 cmd，先进到解压目录 cd /d D:\pkg\ODAC1120320Xcopy_x64 :: 不带参数运行，脚本会依次询问组件、目标目录、Home 名称 install.bat

交互过程大概是这样：先问要装哪些组件（all表示全部，也可以只填odp.net、oledb、asp.net），再问 ORACLE_HOME 目标目录，最后问 Home 名称。目标目录要选一个空目录,比如C:\oracle\odac1120，不要指向已有的 Oracle 安装目录，否则文件会被覆盖，旧 Home 直接损坏。

批处理也支持一次带全参数，适合写进自动化脚本：

:: 参数顺序在不同 11.2.0.3.x 小版本间略有差异，先跑一次无参版本确认提示顺序 install.bat all C:\oracle\odac1120 odac1120

三个参数的语义分别是：组件集合、ORACLE_HOME 路径、Home 名称。Home 名称会作为注册表键HKLM\SOFTWARE\ORACLE\KEY_odac1120的后缀，多个版本共存时靠它区分。装完先确认目标目录里有没有bin\oci.dll，这是判断复制环节是否成功的第一个标志。

3.2 环境变量：PATH 别用 setx 改

环境变量有三条，但写法有讲究。ORACLE_HOME和TNS_ADMIN用setx没问题，PATH 用setx会带来一个常见问题——它只支持 1024 个字符，机器上 PATH 一长，尾部内容会被静默截断，表现为某些命令突然找不到了，而且没有任何报错。

:: 系统级变量，/M 需要管理员权限 setx ORACLE_HOME "C:\oracle\odac1120" /M setx TNS_ADMIN "C:\oracle\odac1120\network\admin" /M

PATH 改用 PowerShell 追加，它没有长度限制：

# 先读再拼再写，避免覆盖已有内容 $old = [Environment]::GetEnvironmentVariable("Path", "Machine") if ($old -notlike "*odac1120*") { [Environment]::SetEnvironmentVariable("Path", "$old;C:\oracle\odac1120\bin", "Machine") }

三个变量的作用不一样。ORACLE_HOME是给 ODP.NET 找oci.dll和消息文件用的；TNS_ADMIN告诉客户端去哪个目录读tnsnames.ora，不设就默认去%ORACLE_HOME%\network\admin；PATH 里的 bin 是为了让tnsping、sqlplus这类工具能在任意目录直接调起来。改完必须开新的命令行窗口才生效，老窗口继承的是旧环境。

3.3 确认 GAC 注册和 machine.config 的 DbProviderFactories

install.bat正常执行完，Oracle.DataAccess.dll会被写进 GAC，machine.config里会多出一条 provider 注册。两件事都要亲自确认，不能只看脚本输出的「完成」。

:: 确认 GAC 里有两个版本（2.x 和 4 各一份，取决于装了哪些组件） gacutil /l Oracle.DataAccess | findstr /i "Version" :: 确认 machine.config 里写入了 provider 条目 findstr /i "Oracle.DataAccess.Client" "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\machine.config"

如果第二条命令没有任何输出，说明注册没写进去，需要手工补。这段配置在<configuration><system.data><DbProviderFactories>下面：

<configuration> <system.data> <DbProviderFactories> <!-- Version 和 PublicKeyToken 必须与 GAC 中的实际强名称一致 --> <add name="Oracle Data Provider for .NET" invariant="Oracle.DataAccess.Client" description="Oracle Data Provider for .NET" type="Oracle.DataAccess.Client.OracleClientFactory, Oracle.DataAccess, Version=2.112.3.0, Culture=neutral, PublicKeyToken=89b483f429c47342" /> </DbProviderFactories> </system.data> </configuration>

invariant这个名字是代码里DbProviderFactories.GetFactory("Oracle.DataAccess.Client")的查找键，写错一个字母就找不到。type里的版本号和公钥标记必须和 GAC 里那份一模一样，抄错了会出现「找到配置但加载失败」。另外注意不要重复添加同名条目，同一台机器上装了两次 ODAC，machine.config里可能已经有这条，再加一次会抛配置节重复的错误。

3.4 tnsnames.ora 和 sqlnet.ora 的最小配置

xcopy 包里通常自带一个network\admin样例目录，但内容是空的。手工建两个文件就够用：

# tnsnames.ora —— 别名方式，中间件配置里写 ORCL_PROD 即可 ORCL_PROD = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = 10.0.0.21)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = orcl) ) )

# sqlnet.ora —— 限制解析顺序，避免去翻 LDAP 或目录服务 SQLNET.AUTHENTICATION_SERVICES = (NTS) NAMES.DIRECTORY_PATH = (TNSNAMES, EZCONNECT)

SERVICE_NAME和SID是两回事，11g 之后绝大多数库用服务名，写错了报ORA-12514，而这个错误看起来像服务端问题，实际是客户端配置写错。NAMES.DIRECTORY_PATH里明确列出TNSNAMES在前，能省掉一类解析超时。文件保存时用 ANSI 或 UTF-8 无 BOM，带 BOM 的tnsnames.ora在某些版本上会让第一行别名解析失败，这是实际遇到过的。

4. 连接配置：连接串、Provider 名与字符集对齐

4.1 三种连接串写法，选一种并统一

ODP.NET 支持三种数据源写法，混用会让排查变得困难。第一种是走 tnsnames 别名，最省事也最推荐，改地址时只动一个文件：

// 别名方式，依赖 TNS_ADMIN 指向的 tnsnames.ora string cs = "User Id=app_user;Password=******;Data Source=ORCL_PROD;" + "Pooling=true;Min Pool Size=1;Max Pool Size=50;Connection Timeout=15;";

第二种是 EZConnect，不依赖任何配置文件，适合临时排查：

// 主机:端口/服务名，注意是斜杠不是冒号 string cs = "User Id=app_user;Password=******;Data Source=10.0.0.21:1521/orcl;";

第三种是完整描述符直接塞进连接串，适合容器化或多环境切换，但可读性最差。Pooling默认就是 true，把它显式写出来是为了让后面接手的人知道连接池开了；Min Pool Size不要设太大，每个连接在服务端都是一个会话，50 个池化连接乘上几个应用实例很快就会触及会话数上限。Connection Timeout默认 15 秒，在跨机房场景下建议调到 30，否则网络稍有抖动就会批量超时。

4.2 Provider 名不能混，两套 API 的层不一样

很容易混淆的一点是，机器上同时存在三套能连 Oracle 的东西：

System.Data.OracleClient从 .NET 4 开始就被标注Obsolete，编译会出警告，但它仍然能跑。如果项目里同时引用了它和 ODP.NET，一个进程里会加载两份 OCI 运行时，表现为偶发的内存访问冲突或连接无故断开，日志里看不出原因。我一般会在项目里全局搜索一遍命名空间，确认只有Oracle.DataAccess.Client这一种。

OLE DB 那条路还要额外确认注册。xcopy 包里的OraOLEDB.dll是需要写进注册表 COM 项的，install.bat选all或oledb时会做。如果只装了odp.net，再用OleDbConnection连 Oracle 就会报「未找到提供程序」。这类程序多为遗留的 ADO 代码或 ETL 工具，跟 .NET 应用不是一套配置，别指望 ODP.NET 装好了它就能用。

4.3 NLS_LANG：编码要从数据库端反推

中文乱码是另一个高频问题，而且成因经常被误判成应用层编码错误。NLS_LANG的格式是<语言>_<地区>.<字符集>，字符集这一节告诉客户端「我发给你的字节流按什么编码解释」。

:: 先查数据库实际的字符集，不要凭感觉设 :: select value from nls_database_parameters where parameter='NLS_CHARACTERSET'; setx NLS_LANG "SIMPLIFIED CHINESE_CHINA.AL32UTF8" /M

如果查询结果显示ZHS16GBK，客户端的NLS_LANG就应该写SIMPLIFIED CHINESE_CHINA.ZHS16GBK；如果显示AL32UTF8，才写上面那条。两边不一致时，Oracle 客户端会做一次隐式转换，转换过程中遇到生僻字或扩展字符就会变成问号，而且插入和查询可能出现不对称的乱码——存进去是对的，读出来是错的，或者反过来。

还有一类情况是变量根本没生效。放在用户级环境变量里，而应用是以服务账号跑的，服务账号读不到当前用户的变量。这种场景下NLS_LANG必须设成系统级（/M），或者干脆在连接串后面加NLS_LANG参数，让配置跟着应用走，而不是跟着机器走。

4.4 ASP.NET 侧还要注册 Oracle.Web

如果项目用了 ASP.NET 的成员资格、角色管理或会话状态，光装 ODP.NET 不够，还需要把Oracle.Web.dll挂上去。这条配置要写进machine.config的<system.web>节，或者写进应用的web.config——后者更可控，因为它是跟着应用走的。

<configuration> <connectionStrings> <add name="OraAspNetConString" connectionString="User Id=asp_user;Password=******;Data Source=ORCL_PROD;" /> </connectionStrings> <system.web> <membership defaultProvider="OracleMembershipProvider"> <providers> <add name="OracleMembershipProvider" type="Oracle.Web.Security.OracleMembershipProvider, Oracle.Web, Version=2.112.3.0, Culture=neutral, PublicKeyToken=89b483f429c47342" connectionStringName="OraAspNetConString" applicationName="/" /> </providers> </membership> </system.web> </configuration>

type里的版本号同样要和Oracle.Web.dll的实际强名称对齐。这套 provider 还要求数据库里有对应的表结构，xcopy 包中附带建表脚本（在asp.net目录下），但脚本本身不会自动执行。只配 config 不建表，页面一访问成员资格功能就会抛异常，错误信息指向表不存在，和安装本身无关。

5. 排查：五个实际踩过的坑，按现象、原因、解决记录

5.1 加载时报「incorrect format」

现象：应用启动或第一次new OracleConnection()时抛BadImageFormatException，提示An attempt was made to load a program with an incorrect format。

原因：进程位数与 ODAC 包位数不匹配。最常见的是 IIS 应用池开了 32 位兼容，或者控制台程序用Framework\v4.0.30319\csc.exe（32 位）编译却在引用 x64 的 DLL。

解决：先确认进程位数（见 2.2 节），要么把应用池的「启用 32 位应用程序」改成 False，要么换 32 位 ODAC 包。改应用池比换包快，重启应用池即可生效，不用重装。

5.2 解析不到连接别名，报 ORA-12154

现象：ORA-12154: TNS:could not resolve the connect identifier specified，但用sqlplus在命令行里同样的别名能连上。

原因：sqlplus和服务进程读的不是同一份tnsnames.ora。可能是TNS_ADMIN设成了用户级变量，服务账号读不到；也可能机器上有两个 Oracle Home，PATH 顺序决定读哪一个。

解决：把TNS_ADMIN设成系统级，然后用tnsping 别名在服务的上下文里验证。实在分不清就读哪一份，临时把连接串换成 EZConnect 写法，绕开解析环节，先确认数据库本身可达。

5.3 提示 provider 与客户端版本不兼容

现象：The provider is not compatible with the version of Oracle client。

原因：GAC 里存在多个Oracle.DataAccess版本，应用引用的版本与实际加载的版本对不上。典型场景是应用目录里复制了一份 DLL，GAC 里还有另一份，运行时按策略选了错误的一份。

解决：用gacutil /l Oracle.DataAccess列出全部版本，把不用的旧版本卸载（需要完整强名称），同时检查应用目录下是否残留Oracle.DataAccess.dll——如果有，删掉，统一走 GAC。多个版本共存本身没问题，前提是应用程序集引用和 GAC 内容严格对应。

5.4 中文写入变问号

现象：插入的中文在数据库里查询显示为?，英文数字正常。

原因：NLS_LANG的字符集部分与数据库NLS_CHARACTERSET不一致，或变量没有对服务进程生效。

解决：按 4.3 节先查数据库字符集，再按系统级设置NLS_LANG，然后重启服务进程。注意setx改完必须重启进程，iisreset只重启 IIS，不会重读系统环境变量——这一点经常被跳过。

5.5 重装时报配置节重复

现象：卸载后重新安装，install.bat执行到一半失败，或者应用启动时报「配置节已定义」。

原因：上一次的machine.config里<DbProviderFactories>条目没有被uninstall.bat清掉，新装时又加了一条同名记录。

解决：从备份恢复machine.config，或者手工删掉重复的<add>节点。这也是 2.3 节强调备份的原因——uninstall.bat的清场并不彻底，GAC 和配置文件都可能留残余。彻底重装的做法是先卸载、再手工检查 GAC 和三个machine.config、最后才重新装。

6. 装完怎么验证：一条命令加一个最小程序

配置做完不等于跑通，需要有一个明确的验证动作。我一般分三层验：文件层、解析层、连接层。

第一层看文件是否到位：

:: 三个关键文件都要存在，缺一个说明组件没装全 dir C:\oracle\odac1120\bin\oci.dll dir C:\oracle\odac1120\odp.net\bin\4\Oracle.DataAccess.dll dir C:\oracle\odac1120\network\admin\tnsnames.ora

第二层看解析是否通，如果 bin 目录下有tnsping.exe就直接用：

:: 返回 OK 说明别名能解析，返回 TNS-03505 说明 tnsnames 有问题 tnsping ORCL_PROD

第三层才是真的连一次。用csc编译一个最小程序，关键在于/platform:x64这个参数——它强制生成 64 位进程，能立刻暴露出位数问题，比在 IIS 里绕一圈再排查快得多。

:: 用 64 位编译器，注意路径是 Framework64 "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe" /platform:x64 ^ /r:C:\oracle\odac1120\odp.net\bin\4\Oracle.DataAccess.dll ^ /out:probe.exe probe.cs

对应的probe.cs只要三件事：打开连接、查一次dual、读一下数据库字符集。

using System; using Oracle.DataAccess.Client; // 引用的是 4.x 目录下的程序集 class Probe { static void Main() { string cs = "User Id=app_user;Password=******;Data Source=ORCL_PROD;Connection Timeout=15;"; using (var conn = new OracleConnection(cs)) { conn.Open(); // 打通连接层 using (var cmd = new OracleCommand("select 1 from dual", conn)) { Console.WriteLine("ping=" + cmd.ExecuteScalar()); // 期望输出 ping=1 } using (var cmd = new OracleCommand( "select value from nls_database_parameters where parameter='NLS_CHARACTERSET'", conn)) { Console.WriteLine("charset=" + cmd.ExecuteScalar()); // 用来核对 NLS_LANG } } } }

输出ping=1表示连接层通了，charset=后面那一串要和 4.3 节设的NLS_LANG对得上。两行都对，这套环境才算真正可用。如果ping通了但业务应用还是连不上，问题基本在应用侧——位数、引用版本、连接串来源这三处，按 5.1 和 5.3 的顺序查。

我习惯把这三层验证做成一个verify.bat放在 ODAC 目录旁边，迁移机器时先跑一遍再部署应用。从那以后我每次装这种 xcopy 版，都强制先备份三份machine.config、先gacutil /l看一眼残留，再动手解压——这大概是被配置节重复和版本错配折磨过之后留下的习惯。希望帮到你。

本文还有配套的精品资源，点击获取