diff --git a/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md b/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md
index e844c1e260113a54ab4677925e8c4f8c899f6ed0..2ba4395fdd18a985beb06650882ac93734ee2fc1 100644
--- a/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md
+++ b/zh-cn/application-dev/reference/apis-arkui/Readme-CN.md
@@ -532,6 +532,7 @@
     - [用户界面外观服务错误码](errorcode-uiappearance.md)
     - [UIExtension错误码](errorcode-uiextension.md)
     <!--DelEnd-->
+    - [XComponent组件错误码](errorcode-xcomponent.md)
   - 图形图像<!--arkui-graphics-images-arkts-errcode-->
     - [屏幕错误码](errorcode-display.md)
     - [窗口错误码](errorcode-window.md)
diff --git a/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md b/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md
index 43f5a4bd19f54208afba73ffe4661309df0bbbba..b204c5d7f2bdc396fa18ee05c276a34761d87cad 100644
--- a/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md
+++ b/zh-cn/application-dev/reference/apis-arkui/_ark_u_i___native_module.md
@@ -2612,7 +2612,7 @@ enum ArkUI_ErrorCode
 | ARKUI_ERROR_CODE_PARAM_INVALID  | 参数错误。  | 
 | ARKUI_ERROR_CODE_CAPI_INIT_ERROR  | 接口初始化错误。<br/>起始版本：18  | 
 | ARKUI_ERROR_CODE_INTERNAL_ERROR  | 出现内部错误，例如内部环境错误导致失败，或者由于内部执行失败导致操作失败。<br/>起始版本：15  | 
-| ARKUI_ERROR_CODE_XCOMPONENT_STATE_INVALID = 103501 | 当前XComponent状态异常，方法调用失败。<br/>起始版本：19  |
+| ARKUI_ERROR_CODE_XCOMPONENT_STATE_INVALID = 103501 | 当前XComponent状态异常，方法调用失败。<br/>起始版本：19<br/>错误码的详细介绍请参见[XComponent组件错误码](../apis-arkui/errorcode-xcomponent.md)。  |
 | ARKUI_ERROR_CODE_ATTRIBUTE_OR_EVENT_NOT_SUPPORTED = 106102  | 组件不支持特定的属性或者事件。<br/>错误码的详细介绍请参见[交互事件错误码](../apis-arkui/errorcode-event.md)。  |
 | ARKUI_ERROR_CODE_ARKTS_NODE_NOT_SUPPORTED = 106103  | 对应的操作不支持ArkTS创建的节点。<br/>错误码的详细介绍请参见[自定义节点错误码](../apis-arkui/errorcode-node.md)。  |
 | ARKUI_ERROR_CODE_ADAPTER_NOT_BOUND = 106104 | 懒加载适配器未绑定到组件上，错误码详细参见[编译错误码](../apis-arkui/errorcode-nodeadapter.md#106104-适配器未绑定)。  |
diff --git a/zh-cn/application-dev/reference/apis-arkui/errorcode-xcomponent.md b/zh-cn/application-dev/reference/apis-arkui/errorcode-xcomponent.md
new file mode 100644
index 0000000000000000000000000000000000000000..345f2c3d9dd51bb00066c853c697913916770e9b
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis-arkui/errorcode-xcomponent.md
@@ -0,0 +1,23 @@
+# XComponent组件错误码
+
+> **说明：**
+>
+> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码](../errorcode-universal.md)。
+
+## 103501 XComponent状态异常
+
+**错误信息**
+
+XComponent is in invalid state.
+
+**错误描述**
+
+当前XComponent状态异常，方法调用失败。
+
+**可能原因**
+
+参考报错接口的说明。
+
+**处理步骤**
+
+确保XComponent持有的Surface状态正常。
diff --git a/zh-cn/application-dev/website.md b/zh-cn/application-dev/website.md
index 4a7d8c28d129789a806323e68cee9fff83e6eb5e..4f4f3278f8d0fb49b5b4fd58dbacf29b52d1df35 100644
--- a/zh-cn/application-dev/website.md
+++ b/zh-cn/application-dev/website.md
@@ -3111,6 +3111,7 @@
           - [用户界面外观服务错误码](reference/apis-arkui/errorcode-uiappearance.md)
           - [UIExtension错误码](reference/apis-arkui/errorcode-uiextension.md)
           <!--DelEnd-->
+          - [XComponent组件错误码](reference/apis-arkui/errorcode-xcomponent.md)
         - 图形图像<!--arkui-graphics-images-arkts-errcode-->
           - [屏幕错误码](reference/apis-arkui/errorcode-display.md)
           - [窗口错误码](reference/apis-arkui/errorcode-window.md)