fix(cms): 修复联系表单手机号长度及格式问题

- 为 CmsContactLead 实体的 name 和 phone 加入 @NotBlank、@Size 及 @Pattern 校验
- 规范 company、delivery、need、source、ip 字段长度限制,防止数据异常
- 在提交服务中新增 sanitizePhone 方法,清除手机号中的空格、横线及括号等分隔符
- 扩展数据库中 phone 字段长度到 VARCHAR(32),支持国际及带分机号格式
- 更新数据库中 name、company、need 字段长度,避免未来数据截断风险
- 补充项目长期记忆文件,记录技术栈及该修复详情
This commit is contained in:
2026-07-19 19:36:38 +08:00
parent 8256817ef7
commit b79cc1003c
5 changed files with 103 additions and 2 deletions

View File

@@ -0,0 +1,19 @@
# 2026-07-19 工作日志
## cms-api phone 字段超长报错修复
- **问题**: cms-api 容器报 `com.mysql.cj.jdbc.exceptions.MysqlDataTruncation: Data truncation: Data too long for column 'phone' at row 1`
- **根因**: 公开接口 `/api/cms/cms-contact-lead/submit` (官网联系表单,无需登录) 前端传入超长/带分隔符的手机号,直接写入 MySQL 触发截断异常
- **影响**: 用户提交联系表单失败,销售线索丢失;公开接口易被刷
- **修复**:
1. `CmsContactLead.java` 实体加 JSR-303 校验: name/phone 加 @NotBlank+@Size+@Patterncompany/delivery/need/source/ip 加 @Size
2. `CmsContactLeadServiceImpl.submit()``sanitizePhone()` 清洗逻辑: 去空格/横线/括号,仅保留 + 和数字
3. 新增 SQL 迁移: `docs/sql/2026-07-19_cms_contact_lead_phone_resize.sql`phone 扩到 VARCHAR(32),同步放宽 name/company/need
## 关联问题(未修复,需前端处理)
- 日志中 `参数类型转换异常: 参数名=id, 传入值=NaN, 期望类型=Integer`:前端 JS 把 NaN 拼到 URL 调用 `@GetMapping("/{id}")`,需前端判空
- `定时任务需要查询所有租户的超时订单 list = 0`:正常 INFO 日志,非错误
## 修改的文件
- src/main/java/com/gxwebsoft/cms/entity/CmsContactLead.java
- src/main/java/com/gxwebsoft/cms/service/impl/CmsContactLeadServiceImpl.java
- docs/sql/2026-07-19_cms_contact_lead_phone_resize.sql (新增)

View File

@@ -0,0 +1,16 @@
# 项目长期记忆
## 项目技术栈
- Spring Boot 2.x + Spring Security 5.7.11 + MyBatis-Plus 3.4.1 + Druid + MySQL
- 验证框架: JSR-303 (javax.validation),通过 spring-boot-starter-web 间接引入,无需额外声明
- 多租户架构: 表普遍有 tenant_id 字段,定时任务需遍历所有租户
- SQL 迁移文件惯例: docs/sql/YYYY-MM-DD_描述.sql
- 实体软删除: @TableLogic + deleted 字段
- 部署方式: Docker (cms-api 容器)
## 已知问题与修复
- 2026-07-19: cms-api 报 `Data too long for column 'phone'`
- 根因: 公开接口 /api/cms/cms-contact-lead/submit 前端传入超长/带分隔符手机号
- 修复: CmsContactLead 实体加 @NotBlank/@Size/@PatternService 加 sanitizePhone 清洗
- SQL: docs/sql/2026-07-19_cms_contact_lead_phone_resize.sql (phone 扩到 VARCHAR(32))
- 前端 bug: id=NaN 传入后端,需前端判空 (Number.isNaN)