diff --git a/docs/google-oauth-deployment.md b/docs/google-oauth-deployment.md
index cd3b351..6d1429d 100644
--- a/docs/google-oauth-deployment.md
+++ b/docs/google-oauth-deployment.md
@@ -45,6 +45,15 @@ export GOOGLE_OAUTH_FRONTEND_RESULT_URL='https://app.example.com/auth/google/res
## 发布验证
+本项目使用 `ruoyi-admin.jar + lib/` 的外置依赖方式发布。执行 Maven `package` 后,必须同时部署:
+
+```text
+ruoyi-admin/target/ruoyi-admin.jar
+ruoyi-admin/target/lib/
+```
+
+不能只替换 `ruoyi-admin.jar`。Google OIDC 至少依赖 `google-api-client-1.34.1.jar`、`google-http-client-1.41.8.jar`、`google-http-client-gson-1.41.8.jar` 和 `google-oauth-client-1.33.2.jar`;缺少 `google-http-client` 会在启动时出现 `NoClassDefFoundError: com/google/api/client/json/JsonFactory`。
+
1. 使用本地账号密码登录,进入个人中心绑定 Google。
2. 退出系统,再从登录页使用已绑定的 Google 账号登录。
3. 使用未绑定的 Google 账号登录,确认页面提示先登录本地账号绑定。
diff --git a/ruoyi-admin/pom.xml b/ruoyi-admin/pom.xml
index 7296fb7..1d2cd0a 100644
--- a/ruoyi-admin/pom.xml
+++ b/ruoyi-admin/pom.xml
@@ -107,6 +107,27 @@
ruoyi-framework
+
+
+ com.google.api-client
+ google-api-client
+ 1.34.1
+
+
+ com.google.http-client
+ google-http-client
+ 1.41.8
+
+
+ com.google.http-client
+ google-http-client-gson
+ 1.41.8
+
+
com.ruoyi
@@ -257,4 +278,4 @@
${project.artifactId}
-
\ No newline at end of file
+