优化

src/shared/api/http.test.ts

@@ -66,6 +66,25 @@ describe('API error diagnostics', () => {
     }
   })
 
+  it('preserves a backend credential error for an explicit login request', () => {
+    const error = new ApiResponseError(
+      '用户名或密码错误',
+      'A0401',
+      undefined,
+      null,
+      'request-login',
+      'trace-login',
+    )
+
+    expect(getApiErrorDetails(error, '登录失败', { preserveAuthenticationMessage: true })).toEqual({
+      message: '用户名或密码错误',
+      code: 'A0401',
+      requestId: 'request-login',
+      traceId: 'trace-login',
+    })
+    expect(getApiErrorDetails(error).message).toBe('登录状态已失效，请重新登录')
+  })
+
   it('extracts identifiers from an HTTP error envelope', () => {
     const error = new axios.AxiosError('Request failed', 'ERR_BAD_RESPONSE', undefined, undefined, {
       status: 503,

src/shared/api/http.ts

@@ -35,6 +35,10 @@ export interface ApiErrorDetails {
   traceId?: string
 }
 
+export interface ApiErrorDetailsOptions {
+  preserveAuthenticationMessage?: boolean
+}
+
 export const http = axios.create({
   baseURL: import.meta.env.VITE_API_BASE_URL || '/api',
   timeout: 15_000,
@@ -113,9 +117,13 @@ export function unwrapApiResponse<T>(response: ApiEnvelope<T>): T {
   return response.data
 }
 
-export function getApiErrorDetails(error: unknown, fallback = '接口请求失败'): ApiErrorDetails {
+export function getApiErrorDetails(
+  error: unknown,
+  fallback = '接口请求失败',
+  options: ApiErrorDetailsOptions = {},
+): ApiErrorDetails {
   if (error instanceof ApiResponseError) {
-    const message = error.code === 'A0401'
+    const message = error.code === 'A0401' && !options.preserveAuthenticationMessage
       ? '登录状态已失效，请重新登录'
       : error.code === 'A0403'
         ? '当前账号无权访问该数据，请联系管理员确认权限'