xinli/二维码功能修复说明.md

二维码功能修复说明

修复时间

2025年1月

修复内容

一、修复快速生成接口404问题

问题：快速生成注册和登录二维码时，前端返回404错误。

原因分析：

1. Spring Boot路径映射可能存在冲突
2. 路径变量 /{qrcodeId} 可能优先匹配 /generate/register 和 /generate/login

修复方案：

1. 将 /generate/register 和 /generate/login 方法移到其他 /generate/* 方法附近，保持一致性
2. 在 @PostMapping 注解中添加 produces = "application/json;charset=UTF-8"，明确指定响应类型
3. 确保 /{qrcodeId} 路径变量方法放在所有具体路径之后

修复后的接口路径：

• POST /psychology/qrcode/generate/register - 快速生成注册二维码
• POST /psychology/qrcode/generate/login - 快速生成登录二维码

二、修复二维码URL生成问题

问题：生成的二维码URL使用后端地址和端口（如 http://1.15.149.240:30081），但前端页面运行在80端口，导致手机扫码无法访问。

修复方案：

1. 优化 buildServerAddress() 方法，优先从 Referer 头提取前端地址
2. 如果检测到后端端口（30081），自动改为前端端口（80，不显示端口号）
3. 生成的二维码URL现在指向前端页面，而不是后端API

修复后的URL格式：

• 本地开发：http://localhost/psychology/qrcode/scan/xxx
• 生产环境：http://1.15.149.240/psychology/qrcode/scan/xxx

三、完善扫码跳转逻辑

功能说明：

1. 扫码接口：GET /psychology/qrcode/scan/{qrcodeCode}（公开接口，使用 @Anonymous 注解）

2. 跳转地址映射：

   • test（测评）→ /psychology/assessment/start?scaleId={id} 或 /psychology/questionnaire/start?questionnaireId={id}
   • view_report（查看报告）→ /psychology/report/detail?reportId={id} 或 /psychology/report/detail?assessmentId={id}
   • register（注册）→ /register
   • login（登录）→ /login

3. 前端扫码页面（scan.vue）：

   • 自动解析URL和查询参数
   • 使用Vue Router进行内部跳转
   • 支持完整URL的外部跳转
   • 提供错误提示和重试机制

测试步骤

1. 重启后端服务

重要：修改代码后必须重启后端服务才能生效。

2. 测试快速生成功能

1. 登录管理系统
2. 进入"二维码管理"页面
3. 点击"快速生成" → "注册二维码"
4. 应成功生成二维码并显示预览
5. 点击"快速生成" → "登录二维码"
6. 应成功生成二维码并显示预览

3. 测试二维码扫码功能

1. 使用手机扫描生成的二维码
2. 应能正常打开扫码页面（/psychology/qrcode/scan/{qrcodeCode}）
3. 根据二维码类型自动跳转到对应页面：
   • 注册二维码 → 跳转到注册页面
   • 登录二维码 → 跳转到登录页面
   • 测评二维码 → 跳转到测评开始页面
   • 报告二维码 → 跳转到报告详情页面

4. 检查二维码URL

生成的二维码URL应该：

• 使用前端地址（80端口），而不是后端地址（30081端口）
• 格式为：http://{host}/psychology/qrcode/scan/{qrcodeCode}
• 手机可以正常访问

关键代码位置

后端

• Controller：ry-xinli-admin/src/main/java/com/ddnai/web/controller/psychology/PsyQrcodeController.java

  • generateRegisterQrcode() - 快速生成注册二维码
  • generateLoginQrcode() - 快速生成登录二维码
  • scan() - 扫码接口
  • buildServerAddress() - 构建服务器地址
  • buildRedirectUrl() - 构建跳转地址

• Service：ry-xinli-system/src/main/java/com/ddnai/system/service/impl/psychology/PsyQrcodeServiceImpl.java

  • generateQrcode() - 生成二维码Base64
  • buildQrcodeContent() - 构建二维码内容URL

前端

• API：xinli-ui/src/api/psychology/qrcode.js

  • generateRegisterQrcode() - 调用快速生成注册二维码接口
  • generateLoginQrcode() - 调用快速生成登录二维码接口
  • scanQrcode() - 调用扫码接口

• 页面：

  • xinli-ui/src/views/psychology/qrcode/index.vue - 二维码管理页面
  • xinli-ui/src/views/psychology/qrcode/scan.vue - 扫码页面

• 路由：xinli-ui/src/router/index.js

  • /psychology/qrcode/scan/:qrcodeCode - 扫码页面路由
  • /register - 注册页面路由
  • /login - 登录页面路由

注意事项

1. 必须重启后端服务：修改代码后必须重启后端服务才能生效
2. 权限检查：快速生成接口需要 psychology:qrcode:add 权限
3. 扫码接口：扫码接口使用 @Anonymous 注解，不需要登录即可访问
4. URL生成：二维码URL会根据请求的 Referer 头自动识别前端地址
5. 端口配置：前端运行在80端口，后端运行在30081端口

如果仍有问题

1. 检查后端日志：查看是否有路径映射错误或权限错误
2. 检查浏览器控制台：查看实际请求的URL和错误信息
3. 检查网络请求：在浏览器开发者工具的Network面板中查看请求详情
4. 确认服务状态：确保后端服务已正确启动并运行在30081端口
5. 确认权限：确保当前用户有 psychology:qrcode:add 权限

修复完成

所有二维码相关功能已修复完成，包括：

• ✅ 快速生成注册二维码
• ✅ 快速生成登录二维码
• ✅ 二维码URL生成（指向前端页面）
• ✅ 扫码跳转功能
• ✅ 测评二维码扫码
• ✅ 报告二维码扫码