diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md
index d82f280e09dd..da04c24bbdcb 100644
--- a/tidb-configuration-file.md
+++ b/tidb-configuration-file.md
@@ -123,6 +123,10 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/
 + 默认值：""
 + 默认情况下，TiDB 版本号格式为：`5.7.${mysql_latest_minor_version}-TiDB-${tidb_version}`。
 
+> **注意：**
+>
+> `server-version` 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。
+
 ### `repair-mode`
 
 + 用于开启非可信修复模式，启动该模式后，可以过滤 `repair-table-list` 名单中坏表的加载。
diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md
index a657a8921d99..8e7db5616fcc 100644
--- a/upgrade-tidb-using-tiup.md
+++ b/upgrade-tidb-using-tiup.md
@@ -22,7 +22,8 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u
 
 > **注意：**
 >
-> 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.2.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.2.0 及后续修订版本。
+> 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.2.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.2.0 及后续修订版本。 
+> 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。
 
 ## 1. 升级兼容性说明