vue2-client 1.20.91 → 1.20.92

package/docs//350/257/267/346/261/202/345/267/245/345/205/267/344/275/277/347/224/250/350/257/264/346/230/216.md

@@ -34,7 +34,7 @@ const result = await post('/api/user/save', { name: '张三' })
 const result = await post('/api/user/save', { name: '张三' }, {
   globalLoading: '保存中...',  // 显示全局 Loading
   dedupe: false,               // 关闭请求去重（POST 默认开启）
-  showErrorMessage: false      // 关闭 code 500 的默认错误提示，由业务自行处理
+  showErrorMessage: false      // 关闭 code 500 / 其他非 200 的默认错误提示，由业务自行处理
 })
 ```
 
@@ -43,7 +43,7 @@ const result = await post('/api/user/save', { name: '张三' }, {
 | 参数 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
 | `globalLoading` | `boolean \| string` | `false` | 是否显示全局 Loading，传字符串可自定义提示文字 |
-| `showErrorMessage` | `boolean` | `true` | 仅对业务 **code 500** 是否显示默认错误提示，设为 `false` 时由业务自行处理 |
+| `showErrorMessage` | `boolean` | `true` | 对业务 **code 500** 及其他非 200（不含 601）是否显示默认错误提示，设为 `false` 时由业务自行处理 |
 | `dedupe` | `boolean` | `true` | 请求去重开关，POST 请求默认开启 |
 
 ### 2. get - GET 请求
@@ -152,13 +152,13 @@ import { runLogic } from '@vue2-client/services/api/common'
 // 基础用法（失败时自动弹出右上角错误提示）
 const result = await runLogic('getUserInfo', { userId: 1 }, 'af-system')
 
-// 关闭 code 500 的默认错误提示，自行处理失败
+// 关闭默认错误提示，自行处理失败
 try {
   const result = await runLogic('getUserInfo', { userId: 1 }, 'af-system', false, {
     showErrorMessage: false
   })
 } catch (msg) {
-  this.$message.warning(msg) // 仅对 500 生效；其他 code 仍会走拦截器默认提示
+  this.$message.warning(msg) // 对 500 及其他非 200 生效；601 等仍会走拦截器默认提示
 }
 ```
 
@@ -167,11 +167,11 @@ try {
 | 参数 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
 | `globalLoading` | `boolean \| string` | `false` | 是否显示全局 Loading |
-| `showErrorMessage` | `boolean` | `true` | 仅对业务 **code 500** 是否显示默认错误提示，设为 `false` 时由业务自行处理 |
+| `showErrorMessage` | `boolean` | `true` | 对业务 **code 500** 及其他非 200（不含 601）是否显示默认错误提示，设为 `false` 时由业务自行处理 |
 | `dedupe` | `boolean` | `true` | 请求去重开关 |
 | `dedupeStrategy` | `string` | 见环境 | 去重策略：`reject` 或 `reuse` |
 
-> 说明：默认错误提示由 `request.js` 响应拦截器通过 Ant Design Vue 的 `notification` 展示（右上角）。`showErrorMessage: false` **仅对业务 code 500**（及 HTTP 500）关闭自动提示；601、其他非 200、401/403 等仍按原逻辑提示。请求仍会 `reject`，便于在 `.catch` 或 `try/catch` 中自定义处理。
+> 说明：默认错误提示由 `request.js` 响应拦截器通过 Ant Design Vue 的 `notification` 展示（右上角）。`showErrorMessage: false` 对 **code 500**、**其他非 200**（及 HTTP 500）关闭自动提示；**601**、401/403 等仍按原逻辑提示。请求仍会 `reject`，便于在 `.catch` 或 `try/catch` 中自定义处理。
 
 ### useRunLogic - 响应式 Hook
 
@@ -214,7 +214,7 @@ export default {
 | `serviceName` | `string` | `VUE_APP_SYSTEM_NAME` | 服务名称 |
 | `isDev` | `boolean` | `false` | 是否使用开发环境 API |
 | `globalLoading` | `boolean \| string` | `false` | 是否显示全局 Loading |
-| `showErrorMessage` | `boolean` | `true` | 仅对业务 **code 500** 是否显示默认错误提示，设为 `false` 时由业务自行处理 |
+| `showErrorMessage` | `boolean` | `true` | 对业务 **code 500** 及其他非 200（不含 601）是否显示默认错误提示，设为 `false` 时由业务自行处理 |
 | `dedupe` | `boolean` | `false` | 请求去重开关 |
 
 ---
@@ -390,7 +390,7 @@ const handleSave = async () => {
   }
 }
 
-// 模式二：需要自定义 500 错误处理（关闭 code 500 的默认 notification）
+// 模式二：需要自定义错误处理（关闭 500 / 其他非 200 的默认 notification）
 const handleSave = async () => {
   const { success, data, error } = await execute(formData, { showErrorMessage: false })
   if (success) {
@@ -415,9 +415,9 @@ const loadData = async () => {
 }
 ```
 
-### 5. 关闭 code 500 的默认错误提示
+### 5. 关闭默认错误提示
 
-当接口返回业务 **code 500**（或 HTTP 500）时，拦截器默认会在右上角弹出 `notification`。若需由业务自行处理 500 错误，在请求 `config` 中设置：
+当接口返回业务 **code 500**、**其他非 200**（或 HTTP 500）时，拦截器默认会在右上角弹出 `notification`。若需由业务自行处理，在请求 `config` 中设置：
 
 ```javascript
 post('/api/xxx', data, { showErrorMessage: false })
@@ -427,6 +427,6 @@ useRunLogic('logicName', { showErrorMessage: false })
 
 **注意：**
 
-- `showErrorMessage: false` **仅对 500** 生效；601、其他非 200、401/403 等仍会弹出默认提示。
-- 不会阻止 Promise 进入 `reject`，仅关闭 500 的自动 notification。
+- `showErrorMessage: false` 对 **500** 与 **其他非 200** 生效；**601**、401/403 等仍会弹出默认提示。
+- 不会阻止 Promise 进入 `reject`，仅关闭上述场景的自动 notification。
 - 登录过期（401）等系统级 `loginExpire` 弹窗不受此配置影响。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vue2-client",
-  "version": "1.20.91",
+  "version": "1.20.92",
   "private": false,
   "scripts": {
     "serve": "SET NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service serve --no-eslint",

package/src/composables/usePost.js

@@ -24,7 +24,7 @@ import { post } from '@vue2-client/services/api/restTools'
  * @param {string} url - 请求地址
  * @param {object} defaultConfig - 默认配置
  * @param {boolean|string} defaultConfig.globalLoading - 是否显示全局 Loading
- * @param {boolean} defaultConfig.showErrorMessage - 业务 code 500 时是否显示默认错误提示（默认 true），设为 false 时由业务自行处理
+ * @param {boolean} defaultConfig.showErrorMessage - 业务 code 500 及其他非 200（不含 601）时是否显示默认错误提示（默认 true），设为 false 时由业务自行处理
  * @param {boolean} defaultConfig.dedupe - 是否启用请求去重（POST 默认开启，设为 false 可关闭）
  * @returns {UsePostReturn}
  *
@@ -47,7 +47,7 @@ import { post } from '@vue2-client/services/api/restTools'
  * await execute({ id: 1 })
  * // data 会自动更新，可直接在模板中使用
  */
-export function usePost (url, defaultConfig = {}) {
+export function usePost(url, defaultConfig = {}) {
   // 响应式状态
   const state = Vue.observable({
     loading: false,
@@ -61,7 +61,7 @@ export function usePost (url, defaultConfig = {}) {
    * @param {object} config - 本次请求的配置（覆盖默认配置）
    * @returns {Promise<RequestResult>} 统一的结果结构
    */
-  async function execute (params = {}, config = {}) {
+  async function execute(params = {}, config = {}) {
     state.loading = true
     state.error = null
 
@@ -80,7 +80,7 @@ export function usePost (url, defaultConfig = {}) {
   /**
    * 重置状态
    */
-  function reset () {
+  function reset() {
     state.loading = false
     state.error = null
     state.data = null
@@ -88,9 +88,15 @@ export function usePost (url, defaultConfig = {}) {
 
   // 返回响应式属性的 getter，确保在模板中能正确响应
   return {
-    get loading () { return state.loading },
-    get error () { return state.error },
-    get data () { return state.data },
+    get loading() {
+      return state.loading
+    },
+    get error() {
+      return state.error
+    },
+    get data() {
+      return state.data
+    },
     execute,
     reset
   }
@@ -117,7 +123,7 @@ export default usePost
  * @param {boolean} options.isDev - 是否为开发环境
  * @param {boolean|string} options.globalLoading - 是否显示全局 Loading
  * @param {boolean} options.dedupe - 是否启用请求去重（POST 默认开启，设为 false 可关闭）
- * @param {boolean} options.showErrorMessage - 业务 code 500 时是否显示默认错误提示（默认 true），设为 false 时由业务自行处理
+ * @param {boolean} options.showErrorMessage - 业务 code 500 及其他非 200（不含 601）时是否显示默认错误提示（默认 true），设为 false 时由业务自行处理
  * @returns {UseRunLogicReturn}
  *
  * @example
@@ -143,7 +149,7 @@ export default usePost
  *   isDev: false
  * })
  */
-export function useRunLogic (logicName, options = {}) {
+export function useRunLogic(logicName, options = {}) {
   const {
     serviceName = process.env.VUE_APP_SYSTEM_NAME,
     isDev = false,
@@ -165,7 +171,7 @@ export function useRunLogic (logicName, options = {}) {
    * @param {boolean} dev - 是否开发环境
    * @returns {string}
    */
-  function buildUrl (svcName, dev) {
+  function buildUrl(svcName, dev) {
     const apiPre = dev ? '/devApi/' : '/api/'
     return `${apiPre}${svcName}/logic/${logicName}`
   }
@@ -176,7 +182,7 @@ export function useRunLogic (logicName, options = {}) {
    * @param {object} overrideOptions - 本次请求的配置（覆盖默认配置）
    * @returns {Promise<RequestResult>} 统一的结果结构
    */
-  async function execute (params = {}, overrideOptions = {}) {
+  async function execute(params = {}, overrideOptions = {}) {
     state.loading = true
     state.error = null
 
@@ -191,7 +197,8 @@ export function useRunLogic (logicName, options = {}) {
     const requestConfig = {
       globalLoading: overrideOptions.globalLoading !== undefined ? overrideOptions.globalLoading : globalLoading,
       dedupe: overrideOptions.dedupe !== undefined ? overrideOptions.dedupe : dedupe,
-      showErrorMessage: overrideOptions.showErrorMessage !== undefined ? overrideOptions.showErrorMessage : showErrorMessage
+      showErrorMessage:
+        overrideOptions.showErrorMessage !== undefined ? overrideOptions.showErrorMessage : showErrorMessage
     }
 
     try {
@@ -209,16 +216,22 @@ export function useRunLogic (logicName, options = {}) {
   /**
    * 重置状态
    */
-  function reset () {
+  function reset() {
     state.loading = false
     state.error = null
     state.data = null
   }
 
   return {
-    get loading () { return state.loading },
-    get error () { return state.error },
-    get data () { return state.data },
+    get loading() {
+      return state.loading
+    },
+    get error() {
+      return state.error
+    },
+    get data() {
+      return state.data
+    },
     execute,
     reset
   }

package/src/services/api/common.js

@@ -182,7 +182,7 @@ export function parseConfig(configContent, configType) {
  * @param {boolean} config.dedupe - 是否启用去重（默认 true）
  * @param {string} config.dedupeStrategy - 去重策略：'reject'（拒绝）或 'reuse'（复用结果）
  * @param {boolean|string} config.globalLoading - 是否显示全局 Loading
- * @param {boolean} config.showErrorMessage - 业务 code 500 时是否显示默认错误提示（默认 true），设为 false 时由业务自行处理
+ * @param {boolean} config.showErrorMessage - 业务 code 500 及其他非 200（不含 601）时是否显示默认错误提示（默认 true），设为 false 时由业务自行处理
  */
 export function runLogic(logicName, parameter, serviceName = process.env.VUE_APP_SYSTEM_NAME, isDev, config = {}) {
   let apiPre = '/api/'

package/src/services/api/restTools.js

@@ -18,7 +18,7 @@ function get (url, parameter) {
  * @param parameter 请求参数
  * @param config 配置项
  * @param {boolean|string} config.globalLoading - 是否显示全局 Loading，可传入字符串作为提示文字
- * @param {boolean} config.showErrorMessage - 业务 code 500 时是否显示默认错误提示（默认 true），设为 false 时由业务自行处理
+ * @param {boolean} config.showErrorMessage - 业务 code 500 及其他非 200（不含 601）时是否显示默认错误提示（默认 true），设为 false 时由业务自行处理
  * @param {boolean} config.dedupe - 是否启用请求去重（POST 默认开启，设为 false 可关闭）
  * @param {string} config.dedupeStrategy - 去重策略：'reject'（拒绝，默认）或 'reuse'（复用结果）
  * @returns {Promise<AxiosResponse<T>>}

package/src/utils/request.js

@@ -30,7 +30,7 @@ import {
 let isReloginShow
 
 /**
- * 业务 code 500 时是否显示默认错误提示（notification）
+ * 业务 code 500 及其他非 200（不含 601）时是否显示默认错误提示（notification）
  * @param {import('axios').AxiosRequestConfig} [config]
  * @returns {boolean}
  */
@@ -401,10 +401,12 @@ function loadInterceptors() {
           description: msg
         })
       } else if (code !== 200) {
-        notification.error({
-          message: '失败',
-          description: msg
-        })
+        if (shouldShowErrorMessage(res.config)) {
+          notification.error({
+            message: '失败',
+            description: msg
+          })
+        }
       } else {
         // 请求成功，通知复用的请求并返回数据
         if (requestKey) {