---
title: 打开 ODC 的 DEBUG 模式-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于打开 ODC 的 DEBUG 模式相关的常见问题和使用技巧，帮助您快速解决打开 ODC 的 DEBUG 模式的难题。
---
切换语言

- 简体中文
- English

划线反馈

# 打开 ODC 的 DEBUG 模式

更新时间：2026-07-08 08:01

适用版本： V3.1.x、V3.2.x、V3.3.x、V3.4.x、V4.0.x、V4.1.x、V4.2.x 内容类型：TechNote  

开启 ODC DEBUG 模式，有助于用户分析 ODC 产品问题时，能够快速分析定位问题。

## 打开 ODC DEBUG 日志级别方法

### Web 版 ODC

配置位于 ODC 容器内，具体配置文件为：`/opt/odc/conf/log4j2.xml`。 修改此文件对应 level 属性为 DEBUG，无需重启 ODC Server，30 秒即可生效。具体步骤如下：

```shell
<Logger name="com.alipay.odc" level="INFO" additivity="false">
  <AppenderRef ref="OdcFileAppender"/>
</Logger>
<Logger name="com.alipay.oceanbase.odc" level="INFO" additivity="false">
  <AppenderRef ref="OdcFileAppender"/>
</Logger>
<Logger name="com.oceanbase.odc" level="INFO" additivity="false">
  <AppenderRef ref="OdcFileAppender"/>
</Logger>

```

### 桌面版 ODC

新建用户环境变量 `ODC_DEBUG_MODE`，值为 `open`。需要重启后，所有的 ODC 实例方可生效。

- Windows 系统下环境变量设置：

   ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/odc/1000.others/200.turn-on-odc-debug-mode/1.png)
 - Linux 系统下环境变量设置：

  ```shell
  export ODC_DEBUG_MODE=open

  ```

## 影响的版本

ODC 所有版本。

Previous

[如何修改 ODC autocommit 属性](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000234591)

Next

[ODC 产品功能介绍持续弹窗规避](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000003046957) ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线