ljwx-health/backup_docs_20260104_182653/ENV_CONFIG_FIX.md

LJWX Health 环境变量配置修复记录

日期: 2025-12-22 06:52 问题: 登录成功但不跳转 - isBackendSuccess check failed 状态: ✅ 已修复

---

问题描述

用户反馈登录后提示"操作成功"，但页面没有跳转到首页。

Console 错误信息

[Request] isBackendSuccess check: 
{
  responseCode: 200,
  expectedCode: undefined,
  success: false
}

---

根本原因

1. 环境变量缺失

文件: ljwx-admin/.env.production

问题: 缺少 VITE_SERVICE_SUCCESS_CODE 及其他关键服务配置变量

影响:

• isBackendSuccess() 函数中，import.meta.env.VITE_SERVICE_SUCCESS_CODE 返回 undefined
• 导致判断逻辑 String(response.data.code) === undefined 永远为 false
• 所有后端响应都被视为失败，即使 HTTP 200 + code 200

2. 代码位置

文件: ljwx-admin/src/service/request/index.ts:93

isBackendSuccess(response) {
  const success = String(response.data.code) === import.meta.env.VITE_SERVICE_SUCCESS_CODE;
  console.log('[Request] isBackendSuccess check:', {
    responseCode: response.data.code,
    expectedCode: import.meta.env.VITE_SERVICE_SUCCESS_CODE, // undefined!
    success
  });
  return success;
}

---

修复方案

1. 更新 .env.production 配置

文件: /root/codes/ljwx-health/ljwx-admin/.env.production

新增配置:

# 后端服务配置
# 成功响应码
VITE_SERVICE_SUCCESS_CODE=200

# 登出响应码（收到这些码时，用户会被登出并重定向到登录页）
VITE_SERVICE_LOGOUT_CODES=600,401

# 模态登出响应码（收到这些码时，显示模态框后登出）
VITE_SERVICE_MODAL_LOGOUT_CODES=401

# Token过期响应码（收到这些码时，刷新token并重新发送请求）
VITE_SERVICE_EXPIRED_TOKEN_CODES=40101

2. 重新构建前端镜像

# 构建新镜像（版本: dev-20251222-064813）
docker build --no-cache \
  -f ljwx-admin/Dockerfile.prod \
  -t harbor.eu.lingjingwanxiang.cn/ljwx-health/ljwx-admin:dev-20251222-064813 \
  ljwx-admin

# 推送到 Harbor
docker push harbor.eu.lingjingwanxiang.cn/ljwx-health/ljwx-admin:dev-20251222-064813

3. 更新 K8s 部署

# 更新镜像
kubectl set image deployment/ljwx-health-admin -n ljwx-health \
  ljwx-admin=harbor.eu.lingjingwanxiang.cn/ljwx-health/ljwx-admin:dev-20251222-064813

# 等待部署完成
kubectl rollout status deployment/ljwx-health-admin -n ljwx-health
# Output: deployment "ljwx-health-admin" successfully rolled out

---

验证结果

构建验证

# 新的 JavaScript bundle
✅ 旧版: index-3PZvLPYt.js
✅ 新版: index-DUQeaw8i.js (不同的 hash 确认新构建)

部署验证

# Pod 状态
$ kubectl get pods -n ljwx-health -l app=ljwx-admin
NAME                                READY   STATUS    RESTARTS   AGE
ljwx-health-admin-9d9bb4d45-2g7cc   1/1     Running   0          24s

# 镜像版本
$ kubectl describe deployment ljwx-health-admin -n ljwx-health | grep Image
Image:      harbor.eu.lingjingwanxiang.cn/ljwx-health/ljwx-admin:dev-20251222-064813

访问验证

# 前端页面
$ curl -k -I https://health-admin.lingjingwanxiang.cn/
HTTP/2 200 
server: nginx/1.29.4
content-type: text/html
✅ 可访问

预期行为

• 用户输入 admin / kt123456 登录
• 后端返回 {code: 200, message: "操作成功", data: {token: "..."}}
• 前端 isBackendSuccess() 判断: "200" === "200" → true
• 自动跳转到首页 /home

---

技术细节

Vite 环境变量机制

1. 构建时替换: Vite 在构建时会将 import.meta.env.VITE_* 替换为实际值
2. 文件优先级:

   .env.production.local   (最高)
   .env.production
   .env.local
   .env                    (最低)
   

3. 前缀要求: 只有 VITE_ 开头的变量会暴露给客户端代码

关键配置说明

环境变量	值	用途
VITE_SERVICE_SUCCESS_CODE	200	判断后端响应成功的标准
VITE_SERVICE_LOGOUT_CODES	600,401	需要登出的错误码
VITE_SERVICE_MODAL_LOGOUT_CODES	401	显示模态框后登出的错误码
VITE_SERVICE_EXPIRED_TOKEN_CODES	40101	Token 过期需要刷新的错误码

后端响应格式

{
  "code": 200,           // ← 与 VITE_SERVICE_SUCCESS_CODE 对比
  "message": "操作成功",
  "data": {
    "token": "eyJ0eXAiOiJKV1QiLCJhbGc..."
  },
  "timestamp": 1734852751840
}

---

相关文件

文件	修改内容	状态
ljwx-admin/.env.production	新增服务配置变量	✅ 已修改
ljwx-admin/src/service/request/index.ts	响应判断逻辑（已有代码）	ℹ️ 无需修改

---

经验教训

1. 环境变量完整性检查

• 生产环境配置文件应包含所有必需的环境变量
• .env.production 不应依赖 .env 的 fallback

2. 构建验证

• 环境变量缺失不会导致构建失败（TypeScript 无法检测）
• 需要在部署前验证关键配置是否存在

3. 调试技巧

• 检查 console 输出中的 undefined 值
• 对比 .env 和 .env.production 的差异
• 验证构建产物的 JavaScript bundle hash 是否变化

4. 最佳实践

• 使用 .env.example 作为配置模板
• 在 CI/CD 中添加环境变量完整性检查
• 关键配置项添加注释说明用途

---

快速诊断清单

遇到类似"操作成功但不跳转"问题时，检查：

• Console 是否显示 expectedCode: undefined
• .env.production 是否包含 VITE_SERVICE_SUCCESS_CODE
• 后端返回的 code 值是否与配置匹配
• 是否重新构建了前端镜像（检查 bundle hash）
• K8s 部署是否使用了新镜像

---

修复完成时间: 2025-12-22 06:52 UTC
部署镜像: dev-20251222-064813
访问地址: https://health-admin.lingjingwanxiang.cn
登录凭证: admin / kt123456

✅ 登录跳转功能已恢复正常