Bug复现
今天在写SpringBoot应用时，写一个后端生成图形验证码的业务时，需要用到session保存后端生成的图形验证码的Base64编码，然后前端通过session来显示图形验证码。
代码里用到了servlet里的HttpSession类，于是idea自动导入了javax.servlet包里的HttpSession。
业务代码如下：
package cn.edu.wit.controller;
import cn.edu.wit.entity.Result;
import com.google.code.kaptcha.impl.DefaultKaptcha;
import com.google.code.kaptcha.util.Config;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
// 注意这里导入的是javax.servlet包
import javax.servlet.http.HttpSession;
import java.awt.image.BufferedImage;
import java.io.ByteArrayOutputStream;
import java.util.Base64;
import javax.imageio.ImageIO;
@Slf4j
@RestController
public class CaptchaController {
private DefaultKaptcha captchaProducer;
public CaptchaController() {
// 配置Kaptcha
captchaProducer = new DefaultKaptcha();
captchaProducer.setConfig(new Config(new java.util.Properties()));
}
@GetMapping("/captcha")
public Result getCaptcha(HttpSession session) throws Exception {
// 生成验证码文本
String captchaText = captchaProducer.createText();
log.info("验证码: " + captchaText);
// 将验证码文本存储在Session中
session.setAttribute("captcha", captchaText);
// 生成验证码图片
BufferedImage image = captchaProducer.createImage(captchaText);
ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
ImageIO.write(image, "jpg", outputStream);
// 转换为Base64
String base64Image = Base64.getEncoder().encodeToString(outputStream.toByteArray());
// 返回给前端Base64编码的图形验证码
return Result.success("data:image/jpeg;base64," + base64Image);
}
}
Postman测试如下：
GET http://localhost:8080/captcha
启动SpringBoot应用后，测试Postman接口，idea控制台报错：
java.lang.IllegalStateException: No primary or single unique constructor found for interface javax.servlet.http.HttpSession
at org.springframework.beans.BeanUtils.getResolvableConstructor(BeanUtils.java:267)
at org.springframework.validation.DataBinder.createObject(DataBinder.java:924)
at org.springframework.validation.DataBinder.construct(DataBinder.java:903)
at org.springframework.web.bind.ServletRequestDataBinder.construct(ServletRequestDataBinder.java:116)
at org.springframework.web.servlet.mvc.method.annotation.ServletModelAttributeMethodProcessor.constructAttribute(ServletModelAttributeMethodProcessor.java:156)
at org.springframework.web.method.annotation.ModelAttributeMethodProcessor.resolveArgument(ModelAttributeMethodProcessor.java:148)
at org.springframework.web.method.support.HandlerMethodArgumentResolverComposite.resolveArgument(HandlerMethodArgumentResolverComposite.java:122)
at org.springframework.web.method.support.InvocableHandlerMethod.getMethodArgumentValues(InvocableHandlerMethod.java:225)
at org.springframework.web.method.support.InvocableHandlerMethod.invokeForRequest(InvocableHandlerMethod.java:178)
at org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:118)
at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.invokeHandlerMethod(RequestMappingHandlerAdapter.java:917)
at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.handleInternal(RequestMappingHandlerAdapter.java:829)
at org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter.handle(AbstractHandlerMethodAdapter.java:87)
at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:1089)
at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:979)
at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:1014)
at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:903)
at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:564)
at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:885)
at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:658)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:205)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:149)
at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:51)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:174)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:149)
at org.springframework.web.filter.RequestContextFilter.doFilterInternal(RequestContextFilter.java:100)
at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:116)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:174)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:149)
at org.springframework.web.filter.FormContentFilter.doFilterInternal(FormContentFilter.java:93)
at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:116)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:174)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:149)
at org.springframework.web.filter.CharacterEncodingFilter.doFilterInternal(CharacterEncodingFilter.java:201)
at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:116)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:174)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:149)
at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:167)
at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:90)
at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:482)
at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:115)
at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:93)
at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:74)
at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:340)
at org.apache.coyote.http11.Http11Processor.service(Http11Processor.java:391)
at org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:63)
at org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:896)
at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1744)
at org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:52)
at org.apache.tomcat.util.threads.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1191)
at org.apache.tomcat.util.threads.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:659)
at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
at java.base/java.lang.Thread.run(Thread.java:842)
Bug原因
从stackoverflow社区找到了错误原因和解决方案
错误原因原文如下：
>Spring Boot 3 (and Spring Framework 6) require a baseline of Jakarte EE 10. You cannot use it with Java EE or Jakarte EE versions below that.
You have to remove the explicit dependency on jakarta.servlet-api from your pom.xml. Java Servlet 4 is below the baseline and in particular still uses the package names starting with javax.servlet.
中文机翻：
Spring Boot 3（和 Spring Framework 6）需要 Jakarte EE 10 的基线。您不能将其与 Java EE 或低于该版本的 Jakarte EE 版本一起使用。
您必须jakarta.servlet-api从您的pom.xml. Java Servlet 4 低于基线，特别是仍然使用以javax.servlet.
bug修复方法很简单，就是将所有的javax.servlet包替换成jakarta.servlet包。
例如我的代码里就应该这样修改：
// import javax.servlet.http.HttpSession;
// 将javax替换成jakarta
import jakarta.servlet.http.HttpSession;
修改后，重新运行SpringBoot应用即可正常生成图形验证码，并保存到session里返回给前端。
将生成的base64字符串通过一个简单的html程序验证一下是否正确：
<img id="captchaImage"
src="data:image/jpeg;base64,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"
alt="Captcha" />
