BackboneJS前端发正常邮箱，Java Spring服务接收格式异常求助

看起来你遇到的是**邮箱地址中的@符号被转成HTML实体@，且&又被二次转义成&**导致的问题，最终后端收到abc@gmail.com（你看到的abc&64;gmail.com应该是显示截断），进而触发格式校验错误。结合你的技术栈，我整理了几个核心排查方向和解决方案：

一、先定位问题根源：抓包确认前端发送的原始数据 #

第一步一定要用浏览器开发者工具的「Network」面板抓包，查看请求的Payload/Form Data：

• 如果前端发送的已经是abc@gmail.com或abc@gmail.com，问题出在前端编码逻辑；
• 如果前端发送的是正常的abc@gmail.com，问题出在后端解码配置或中间层转发。

二、前端（Backbone+jQuery）问题排查与修复 #

1. 检查邮箱值的获取方式 #

如果用html()获取输入框内容，会自动转义HTML实体，而val()会获取原始输入值：

// ❌ 错误：用html()会转义@为@
var email = $('#email-input').html();

// ✅ 正确：用val()获取用户输入的原始文本
var email = $('#email-input').val();

2. 检查Backbone Model的序列化逻辑 #

如果是通过Backbone Model发送请求，确认是否在toJSON()或请求拦截器中做了不必要的HTML编码：

// 检查Model是否有自定义转义逻辑
var UserModel = Backbone.Model.extend({
  toJSON: function() {
    var attrs = Backbone.Model.prototype.toJSON.call(this);
    // 避免手动做HTML转义，比如不要用$(document.createElement('div')).text(attrs.email).html();
    return attrs;
  }
});

三、后端（Java Spring）问题排查与修复 #

1. 配置字符编码过滤器 #

确保Spring正确处理请求编码，避免二次转义。在配置类中添加：

import org.springframework.web.filter.CharacterEncodingFilter;
import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class WebConfig {
    @Bean
    public FilterRegistrationBean<CharacterEncodingFilter> characterEncodingFilter() {
        FilterRegistrationBean<CharacterEncodingFilter> registrationBean = new FilterRegistrationBean<>();
        CharacterEncodingFilter filter = new CharacterEncodingFilter();
        filter.setEncoding("UTF-8");
        filter.setForceEncoding(true); // 强制设置请求和响应编码
        registrationBean.setFilter(filter);
        registrationBean.addUrlPatterns("/*");
        return registrationBean;
    }
}

2. 手动解码HTML实体（应急方案） #

如果暂时无法定位编码源头，可以在后端接收时手动解码：

import org.springframework.web.util.HtmlUtils;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class EmailController {
    @PostMapping("/submit-email")
    public String submitEmail(@RequestParam String email) {
        // 解码HTML实体，将@还原为@
        String decodedEmail = HtmlUtils.htmlUnescape(email);
        // 后续处理decodedEmail
        return "Received email: " + decodedEmail;
    }
}

3. JSON请求的Jackson配置 #

如果是接收JSON格式的请求，确保Jackson开启HTML实体解码：
在application.properties中添加：

spring.jackson.deserialization.html-entity-decoding=true

四、中间层排查 #

如果你的服务前面有Nginx或API网关，检查是否配置了自动HTML编码的规则，比如某些网关会对请求参数做转义，需要关闭此类配置。

先从抓包开始定位，大部分情况都是前端获取值的方式错误或者Spring编码配置缺失导致的，按上面的步骤应该能解决问题。

内容的提问来源于stack exchange，提问作者S P