diff --git a/docs/tutorial/mp-harmony/intro.md b/docs/tutorial/mp-harmony/intro.md
index 5666a5baa3d6ad98577f1b0b76585bee0b415ae9..01e62efdc5a1b5afe4d31b21e0dcd0eb958e5ffd 100644
--- a/docs/tutorial/mp-harmony/intro.md
+++ b/docs/tutorial/mp-harmony/intro.md
@@ -417,6 +417,12 @@ Map 和相关定位需要 [华为AppGallery Connect 后台](https://developer.hu
 ```
 3. 第一次启动会跳转到应用市场访问应用，网络问题可能会超时，重试两次就可以。正式上架后不会出现此问题。
 
+### 运行报错 `code:9568305 error: Failed to install the HAP or HSP because the dependent module does not exist.`@failed-to-install-the-hap-or-hsp-9568305
+
+此问题发行后不会出现，仅运行调试时有概率出现。
+
+出现此问题时，请用鸿蒙 Next 真机，在手机搜索框输入uniapp，并点击出现的元服务 helloUniApp，点打开，然后再关闭，最后在hbx重启项目即可
+
 ### 分包 `The subpackage path name does not meet the requirements`
 
 已修复。参考 [运行报错](#failed-to-install-the-hap-or-hsp) 调整 hvigor 版本号。