diff --git a/docs/en/hadoop_java_sdk.md b/docs/en/hadoop_java_sdk.md
index 323aaa115aea5c1794d2cc0301a6bcb5c85935a9..36fd33ccddc3eec0775c1c1af11a6a045fca4afd 100644
--- a/docs/en/hadoop_java_sdk.md
+++ b/docs/en/hadoop_java_sdk.md
@@ -2,6 +2,8 @@
 
 JuiceFS provides [Hadoop-compatible FileSystem](https://hadoop.apache.org/docs/current/hadoop-project-dist/hadoop-common/filesystem/introduction.html) by Hadoop Java SDK to support variety of components in Hadoop ecosystem.
 
+**NOTICE: JuiceFS use local user uid mapping. So, you should sync all the needed users and their uids across the whole Hadoop Cluster to avoid permission error.**
+
 ## Hadoop Compatibility
 
 JuiceFS Hadoop Java SDK is compatible with Hadoop 2.x and Hadoop 3.x. As well as variety of components in Hadoop ecosystem.
diff --git a/docs/zh_cn/hadoop_java_sdk.md b/docs/zh_cn/hadoop_java_sdk.md
index c7160200007fcdcaac83c71685169bb0a10f2dea..ba377475b9f614540ef3aee7f576bd9f7ab31003 100644
--- a/docs/zh_cn/hadoop_java_sdk.md
+++ b/docs/zh_cn/hadoop_java_sdk.md
@@ -2,6 +2,8 @@
 
 JuiceFS 提供兼容 HDFS 接口的 Java 客户端来支持 Hadoop 生态中的各种应用。
 
+**注意：由于 JuiceFS 使用本地的 user 和 uid 映射。因此，在分布式环境下使用，需要同步所有需要使用的 user 和 uid 到所有的 Hadoop 节点上，以避免权限问题。**
+
 ## Hadoop 兼容性
 
 JuiceFS Hadoop Java SDK 同时兼容 Hadoop 2.x 以及 Hadoop 3.x 环境，以及 Hadoop 生态中的各种主流组件。