---
title: Exchange 环境中 OAB 下载失败并报 0x80190197 的排查与处理
description: Outlook 客户端下载脱机通讯簿时可能因 IE 代理配置或 BITS 认证条件不满足而返回 0x80190197，该错误对应 HTTP 407 代理认证问题。本文面向企业 IT 运维，说明适用场景、准备与风险、排查步骤、验证方法、回退建议及常见问题。
url: "https://www.lanever.com/docs/exchange-%e7%8e%af%e5%a2%83%e4%b8%ad-oab-%e4%b8%8b%e8%bd%bd%e5%a4%b1%e8%b4%a5%e5%b9%b6%e6%8a%a5-0x80190197-%e7%9a%84%e6%8e%92%e6%9f%a5%e4%b8%8e%e5%a4%84%e7%90%86/"
updated: "2026-10-12"
category: Exchange
---

# Exchange 环境中 OAB 下载失败并报 0x80190197 的排查与处理

> **参考来源与致谢**
>
>
>
> - **引用来源：**[OAB Downloads fail with 0x80190197 - Dgoldman's WebLog - Site Home - MSDN Blogs](http://blogs.msdn.com/b/dgoldman/archive/2007/02/15/oab-downloads-fail-with-0x80190197.aspx)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

企业内 Outlook 客户端通过 Web 分发方式下载脱机通讯簿（OAB）时失败，客户端或日志中出现错误码 `0x80190197`。该错误在十六进制下对应 `BG_E_HTTP_ERROR_407`，本质是 HTTP 407 代理认证问题。常见于客户端所在网络使用代理服务器、代理配置脚本或自动配置，且代理要求集成 Windows 认证的环境。

Outlook 在建立连接时会通过 Windows API 读取 Windows 客户端的 Internet Explorer 代理设置。若代理设置指向不可用或不可访问的代理，连接可能失败。需注意：Outlook 一旦按代理配置尝试连接失败，通常不会自动改为直连。

## 准备与风险

- 确认受影响范围：单台客户端、某个子网还是整个站点。
- 准备测试环境，先在单台非关键客户端复现并验证，再推广到批量。
- 修改注册表或组策略前，先导出相关注册表分支或记录当前策略值，便于回退。
- 涉及注册表路径 `HKEY_LOCAL_MACHINESYSTEMCurrentControlSetControlLsaLmCompatibilityLevel` 时，改动可能影响认证兼容性，须评估后再操作。
- 不要在未备份的情况下批量下发策略或删除代理配置。

## 处理步骤

### 方向一：检查代理配置

1. 确认客户端使用的代理服务器处于运行状态且网络可达。
2. 检查组策略或 IEAK 下发的代理设置，确认没有指向失效的代理地址或错误的配置脚本。
3. 在客户端上用 Internet Explorer 访问 Outlook 尝试连接的同一 URL，确认能否正常连通。
4. 若确认代理配置有误，修正策略后刷新客户端策略并重试。

### 方向二：检查 BITS 相关条件

使用 BITS 传输时也可能出现同一错误码。当以下条件同时成立时容易触发：调用方未通过 `IBackgroundCopyJob2::SetCredentials` 指定可使用客户端凭据；客户端 `LmCompatibilityLevel` 值为 0 或 1；文件传输经过要求集成 Windows 认证的服务器或代理。

此时可参考对应版本的官方文档调整行为，例如通过注册表项改变相关设置。具体键值与适用范围请查阅对应版本的官方文档，不要凭经验直接套用。

## 验证方法

- 在测试客户端手动触发 OAB 下载，观察是否仍返回 `0x80190197`。
- 查看客户端与服务器相关日志，确认错误码是否消失。
- 确认 OAB 文件已更新到本地缓存目录，且版本符合预期。
- 在多台不同子网客户端上抽样验证，排除单点网络问题。

## 回退建议

- 若修改注册表后问题未解决或引入新问题，恢复此前导出的注册表值。
- 若调整了组策略，恢复原策略设置并重新刷新客户端。
- 回退后重新验证 OAB 下载与客户端连接状态，确认恢复原状。

## 常见问题

- 问：为什么代理不可用会导致 OAB 下载失败？答：Outlook 按 IE 代理设置尝试连接，失败后不会自动直连。
- 问：关闭代理是否可行？答：可作为临时验证手段，但通常不是理想长期方案，应优先修正代理配置或认证条件。
- 问：错误码含义是什么？答：`0x80190197` 对应 HTTP 407，即代理认证问题。
- 问：如何确认是否与 BITS 有关？答：结合客户端 BITS 使用情况、`LmCompatibilityLevel` 取值及代理认证要求综合判断，必要时查阅对应版本官方文档。

> 提示：不同 Exchange 与 Outlook 版本行为可能存在差异，涉及注册表、组策略或认证设置时，请以对应版本的官方文档为准。
