简介基于SSM框架的邮件收发系统源码数据库是一套面向Java方向毕业生、课程设计学生及需要快速搭建可用项目的开发者的完整项目。系统涵盖用户管理、邮件收发、好友维护等核心模块前台页面与后台逻辑齐全配合SQL脚本部署即可运行。包体共403个文件以Java源码、JSP页面、XML配置、SQL脚本、jar依赖包为主辅以CSS、JS等前端资源和大量PNG、GIF图片压缩包约32.61MB源码中包含Controller、Service、实体映射类及MyBatis生成的Example类结构清晰便于二次开发与答辩讲解。目前已有107人学习下载。项目带有详细代码注释个人手打98分经过严格调试界面美观、操作简单功能完善且有较高实际应用价值适合直接作为毕业设计、期末大作业或课程设计的高分参考。1. 把“SSM邮件收发系统”做成能通过答辩的项目到底在做什么一个典型的毕设题目落到“基于SSM框架的邮件收发系统源码数据库”上真正要交付的不是一个会发信的工具而是四个能当面回答的问题SSM三个框架怎么整合、邮件协议是怎么工作的、数据库表怎么设计才不像玩具、代码里哪些地方会被答辩老师追问。选题把“会写Java Web”这件事拆成了可见的工程能力比单纯做一个CRUD管理系统更有区分度这也是它在毕设题目里一直热门的原因。邮件收发系统的难点不在界面而在两个容易被低估的地方一是SMTP/POP3/IMAP协议细节二是“收下来的邮件到底存成什么样”。很多组把时间花在页面上最后卡在附件解析和中文乱码上。这篇按“理论能讲清、代码能复现、数据库能落地”的顺序写最终落到一份可以直接核验字段和配置的源码检查清单上。2. 邮件收发系统的SSM选型与项目骨架搭建2.1 SSM三件套在邮件收发系统里分别承担什么SSM 是 Spring、SpringMVC、MyBatis 三个框架的缩写它们在邮件收发系统里各管一段边界很清楚组件职责在邮件系统里的落点Spring管理对象生命周期与事务邮件发送服务、接收服务、附件处理服务的Bean统一由容器托管SpringMVC处理HTTP请求与响应/mail/send、/mail/list、/mail/detail等地址映射到ControllerMyBatis数据库持久化用户、已收邮件、已发邮件、附件的增删改查毕设选SSM而不是直接上Spring Boot不是因为SSM更简单而是答辩时“配置”本身就是考点。Spring的依赖注入怎么生效、SpringMVC的DispatcherServlet在web.xml里怎么注册、MyBatis的Mapper接口怎么扫描这些问题是SSM项目的天然素材。我一般建议保留手写配置不要全部换成注解不然答辩时“框架整合过程”没法展开讲。2.2 源码的包结构怎么摆才算“成体系的SSM工程”常见的做法是用Maven建工程包名按业务竖切。下面这个结构适合邮件收发系统也容易被看出做过工程化思考ssm-mail/ ├── pom.xml ├── src/main/java/com/example/mail/ │ ├── controller/ # 邮件页面与操作入口 │ │ ├── MailSendController.java │ │ └── MailReceiveController.java │ ├── service/ # 业务层收发逻辑、附件落盘 │ │ ├── MailSendService.java │ │ ├── MailReceiveService.java │ │ └── impl/ │ ├── mapper/ # MyBatis Mapper接口 │ │ ├── UserMapper.java │ │ └── MailMapper.java │ ├── pojo/ # 数据库实体 │ │ ├── User.java │ │ ├── ReceivedMail.java │ │ └── SentMail.java │ ├── util/ # JavaMail封装、日期处理 │ │ ├── MailSenderUtil.java │ │ └── MailReceiverUtil.java │ └── config/ └── src/main/resources/ ├── jdbc.properties # 数据库连接参数 ├── spring-mybatis.xml # Spring与MyBatis整合 ├── spring-mvc.xml # SpringMVC扫描与视图解析 └── mapper/ # Mapper XML文件 ├── UserMapper.xml └── MailMapper.xml分层逻辑是Controller只管拿参数和返回视图Service负责组合JavaMail与数据库操作Mapper只接触SQL。包名里的util放JavaMail的封装类因为JavaMail本身不是Spring组件封装后交给Service调用更顺手。2.3 Spring与MyBatis整合配置里必须有的四个点spring-mybatis.xml是SSM项目的“地基”。一个能搜到邮件、能存邮件的配置至少包含四样东西数据源、SqlSessionFactory、Mapper扫描、事务管理器。核心片段如下context:property-placeholder locationclasspath:jdbc.properties/ bean iddataSource classcom.alibaba.druid.pool.DruidDataSource property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.example.mail.mapper/ /bean bean idtransactionManager classorg.springframework.jdbc.datasource.DataSourceTransactionManager property namedataSource refdataSource/ /beanmapperLocations指向XML文件目录basePackage指向Mapper接口所在包。“扫码收信后写库”这类操作同时涉及收件箱更新和邮件插入如果不做事务收信成功但入库失败时会出现“邮件丢了但不知情”的情况。数据源选Druid而不是默认的DriverManagerDataSource是为了拿监控页和连接池能力这在答辩时也能作为亮点提一句。写完后先用一个最简单的Controller验证容器能启动再往里面加邮件业务而不是一上来就把收发逻辑堆进去。3. 邮件协议工作方式与JavaMail收发核心实现3.1 SMTP、POP3、IMAP的协议分工怎么给答辩老师讲邮件收发不是一个Java方法从头做到尾中间隔着协议。发送统一走SMTP收件则分POP3和IMAP三者在邮件收发系统里的关系是协议全称端口SSL典型用途SMTPSimple Mail Transfer Protocol465 / 587把邮件从客户端推送到邮件服务器POP3Post Office Protocol 3995把邮件从服务器下载到本地服务器端通常删除原文IMAPInternet Message Access Protocol993客户端与服务器同步邮件状态服务器保留原邮件毕设推荐收件用IMAP原因很实际POP3把邮件取走后服务器就没了重复拉取会出现“第一遍收10封第二遍收0封”的效果不仅数据库难自圆其说演示时也容易翻车。IMAP可以用UID做增量同步同一个邮箱反复测试也不会重复入库。3.2 JavaMail的Maven依赖与连接参数授权码才是密码JavaMail不在Spring框架内需要单独引依赖。SSM项目大多跑在Java 8上用javax.mail1.6.2 最稳dependency groupIdjavax.mail/groupId artifactIdmail/artifactId version1.6.2/version /dependency然后要意识到一个高频翻车点新浪、QQ、网易等邮箱的SMTP/POP3/IMAP服务登录密码不是邮箱登录密码而是“授权码”。授权码在邮箱网页端的“设置—账户—IMAP/SMTP服务”里开启后生成。代码里props.put(mail.smtp.auth, true)必须配否则服务器会返回530 Authentication错误。3.3 发送邮件用MimeMessage组装一封带文本和附件的信这是源码里最常见的发送封装。下面这段覆盖了连接配置、收件人解析和带附件发送public void sendWithAttachment(String to, String subject, String content, String attachPath) throws MessagingException { // 1. 准备连接参数 Properties props new Properties(); props.put(mail.smtp.host, smtp.qq.com); props.put(mail.smtp.port, 465); props.put(mail.smtp.auth, true); props.put(mail.smtp.ssl.enable, true); // 465端口强制SSL // 2. 创建带授权码的会话 Session session Session.getInstance(props, new Authenticator() { Override protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication(senderqq.com, 授权码); } }); // 3. 构建邮件内容 MimeMessage message new MimeMessage(session); message.setFrom(new InternetAddress(senderqq.com)); message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to)); message.setSubject(subject, UTF-8); // 4. 文本与附件组装成multipart MimeMultipart multipart new MimeMultipart(); MimeBodyPart textPart new MimeBodyPart(); textPart.setText(content, UTF-8); multipart.addBodyPart(textPart); if (attachPath ! null !attachPath.isEmpty()) { MimeBodyPart attachPart new MimeBodyPart(); attachPart.attachFile(new File(attachPath)); multipart.addBodyPart(attachPart); } message.setContent(multipart); Transport.send(message); // 发送 }两个参数值得细说setSubject和setText都显式传了UTF-8否则中文标题在部分客户端里会变成乱码multipart的顺序是先文本后附件有的邮件客户端对只有附件的纯multipart解析很怪保留一个空文本段能规避异常。smtp.ssl.enabletrue只适用于465端口如果改成587端口需要用STARTTLS。3.4 接收邮件用IMAP协议按UID增量拉取收件箱接收相比发送更复杂因为要遍历Folder、判断邮件类型、还要处理“已经收过的不要再收”。可以基于IMAP的UIDFolder实现增量拉取public void receiveIncremental(String host, int port, String user, String authCode) throws Exception { Properties props new Properties(); props.put(mail.store.protocol, imap); props.put(mail.imap.host, host); props.put(mail.imap.port, String.valueOf(port)); props.put(mail.imap.ssl.enable, true); Session session Session.getInstance(props); Store store session.getStore(imap); store.connect(user, authCode); Folder folder store.getFolder(INBOX); FolderUID folderUid (FolderUID) folder; folder.open(Folder.READ_ONLY); // 从上次记录的最大UID开始拉取 int lastUid mailMapper.getLastUid(); UIDFolder uidFolder (UIDFolder) folder; Message[] messages uidFolder.getMessagesByUID(lastUid 1, UIDFolder.LASTUID); for (Message msg : messages) { long uid uidFolder.getUID(msg); String subject msg.getSubject(); String from InternetAddress.toString(msg.getFrom()); Object body msg.getContent(); if (body instanceof Multipart) { // 遍历bodyParttext/plain部分存正文其他部分存附件 Multipart mp (Multipart) body; for (int i 0; i mp.getCount(); i) { BodyPart part mp.getBodyPart(i); String disposition part.getDisposition(); if (Part.ATTACHMENT.equalsIgnoreCase(disposition)) { // 附件写入本地目录同时记录文件名 } else { // 正文文本存数据库 } } } mailMapper.insertReceivedMail(uid, from, subject, ...); } folder.close(false); store.close(); }folder.open(Folder.READ_ONLY)是故意用只读模式防止JavaMail把邮件标记为已读影响演示时刷新状态的判断。getMessagesByUID(lastUid 1, LASTUID)是增量同步的关键把上次最大的UID存到一张配置表或内存Map里下次启动就不会重复入库。注意FolderUID是笔误实际类型是UIDFolder二者含义不同判断附件时disposition可能为null此时要以part.getFileName() ! null作为兜底判断。4. 邮件收发系统的数据库设计与MyBatis持久化4.1 用户、邮件、附件三张核心表怎么建才能应对答辩追问邮件系统数据库不能只做一张“邮件表”。至少要拆出用户表、已收邮件表、已发邮件表和附件表。下面以收件箱为核心给出建表SQL字符集用utf8mb4因为它能存4字节Emoji表情邮件正文里出现这类字符很常见CREATE TABLE mail_user ( id INT PRIMARY KEY AUTO_INCREMENT, email VARCHAR(128) NOT NULL UNIQUE, password VARCHAR(255) NOT NULL, smtp_host VARCHAR(128), imap_host VARCHAR(128), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE received_mail ( id INT PRIMARY KEY AUTO_INCREMENT, uid BIGINT NOT NULL COMMENT IMAP的UID用于增量同步, user_id INT NOT NULL, from_address VARCHAR(128) NOT NULL, subject VARCHAR(512), content LONGTEXT, receive_time DATETIME, has_attachment TINYINT DEFAULT 0, read_flag TINYINT DEFAULT 0, UNIQUE KEY uk_user_uid (user_id, uid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE mail_attachment ( id INT PRIMARY KEY AUTO_INCREMENT, mail_id INT NOT NULL, file_name VARCHAR(255) NOT NULL, file_path VARCHAR(512) NOT NULL, file_size BIGINT ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;received_mail表有两个细节要在答辩时主动讲一是uid和user_id建了唯一索引uk_user_uid保证同一个邮箱账号下同一封邮件不会因重复拉取而插入两次二是content用LONGTEXT而不是VARCHAR(500)因为HTML邮件正文轻易超过几千字符用VARCHAR会被MySQL截断。mail_attachment并不直接存文件二进制只存文件路径。文件存服务器磁盘数据库只维护“哪封邮件有哪些附件”的映射关系否则数据库文件会迅速膨胀备份也很慢。4.2 Mapper.xml里邮件的动态SQL怎么写才不留漏洞MyBatis的优势在“动态SQL”。收件箱列表要按read_flag筛选搜索邮件要按subject模糊查询这些用Mapper XML写比拼接Java字符串清晰得多select idlistReceivedMail resultTypecom.example.mail.pojo.ReceivedMail SELECT id, uid, from_address, subject, receive_time, read_flag, has_attachment FROM received_mail where if testuserId ! null AND user_id #{userId} /if if testkeyword ! null and keyword ! AND (subject LIKE CONCAT(%, #{keyword}, %) OR from_address LIKE CONCAT(%, #{keyword}, %)) /if if testunreadOnly ! null and unreadOnly AND read_flag 0 /if /where ORDER BY receive_time DESC LIMIT #{offset}, #{pageSize} /selectwhere标签会自动去掉第一个AND这样三个条件任意组合不会拼出语法错误。LIMIT #{offset}, #{pageSize}是分页参数不要在Java层把全部邮件查出来再截取邮件量大时全表加载会把Tomcat内存耗尽。这里没有用PageHelper插件原因是毕设里手写分页更能展示对SQL的理解用插件反而容易被追问“底层怎么实现的”。4.3 数据库连接与表结构调整时容易被绕进去的坑在Navicat或命令行里调表结构前先确认jdbc.properties里的URL是否带了时区参数jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/ssm_mail?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456serverTimezoneAsia/Shanghai是MySQL 8.x的强制要求缺失时连接报The server time zone value异常。字符集参数characterEncodingutf8要与表的utf8mb4一致否则收下来的邮件入库后再查出来中文在页面与控制台之间反复横跳一会正常一会乱码。表结构改动后Mapper里对应的字段名要同步核对。MyBatis默认开启驼峰映射还要在配置里确认setting namemapUnderscoreToCamelCase valuetrue/否则数据库的from_address映射不到实体类的fromAddress属性运行时不报错但查询结果全是null这种问题最花时间。5. 高分答辩现场要验证的四件事从真实邮箱闭环到源码检查5.1 用两个真实邮箱跑通收发闭环开发完第一件事不是截图上交而是准备两个真实邮箱做端到端验证。常见的做法是拿QQ邮箱发到163邮箱再从163的IMAP收下来注意两个邮箱都要在设置里开启SMTP/IMAP服务并生成授权码。验证顺序固定为先发后收收的时候看控制台是否打印UID和水票字段再开QQ邮箱网页端确认对方邮件已到达。测试时不要用同一个邮箱给同一封邮件群发多遍邮箱服务商有发信频率限制连续快速发送会触发风控。每分钟发一封、连续发十封是安全的节奏。5.2 三个高频报错与对应处理方式报错关键词真实原因处理方式535 Authentication failed密码位用了邮箱登录密码而非授权码到邮箱设置里生成授权码替换jdbc.properties或常量里的对应值Connection timed out端口或SSL配置不一致465端口配ssl.enabletrue587端口配starttls.enabletrueMissing attachmentgetDisposition()返回null但文件名存在判断条件改为fileName ! null出现第一类报错时多数人第一反应是去看防火墙其实99%的情况就是授权码问题。5.3 源码里的三处加分自查项交付源码前检查这三个地方第一MailSenderUtil和MailReceiverUtil里的邮箱地址与授权码是否写在常量类中而不是散落在Controller里第二pom.xml中是否声明了Druid连接池依赖如果没有spring-mybatis.xml里的Druid类会直接启动报错第三resources/sql/目录下是否有建库建表脚本答辩翻源码演示时直接执行脚本能重建库这才算得上“源码数据库”完整交付。最后一个加分项是把IMAP接收封装成定时任务比如用Spring的Scheduled注解每三分钟拉取一次新邮件。这个功能在答辩演示时效果很直观网页端发一封邮件稍等片刻系统自动收到并入库比手动点击“收信”按钮更有冲击力。定时任务里给ReceiveService加一个synchronized锁避免上一次拉取还没结束下一次又启动重复消费同一批UID邮件。本文还有配套的精品资源点击获取 基于SSM框架的邮件收发系统设计与实现全解析
简介基于SSM框架的邮件收发系统源码数据库是一套面向Java方向毕业生、课程设计学生及需要快速搭建可用项目的开发者的完整项目。系统涵盖用户管理、邮件收发、好友维护等核心模块前台页面与后台逻辑齐全配合SQL脚本部署即可运行。包体共403个文件以Java源码、JSP页面、XML配置、SQL脚本、jar依赖包为主辅以CSS、JS等前端资源和大量PNG、GIF图片压缩包约32.61MB源码中包含Controller、Service、实体映射类及MyBatis生成的Example类结构清晰便于二次开发与答辩讲解。目前已有107人学习下载。项目带有详细代码注释个人手打98分经过严格调试界面美观、操作简单功能完善且有较高实际应用价值适合直接作为毕业设计、期末大作业或课程设计的高分参考。1. 把“SSM邮件收发系统”做成能通过答辩的项目到底在做什么一个典型的毕设题目落到“基于SSM框架的邮件收发系统源码数据库”上真正要交付的不是一个会发信的工具而是四个能当面回答的问题SSM三个框架怎么整合、邮件协议是怎么工作的、数据库表怎么设计才不像玩具、代码里哪些地方会被答辩老师追问。选题把“会写Java Web”这件事拆成了可见的工程能力比单纯做一个CRUD管理系统更有区分度这也是它在毕设题目里一直热门的原因。邮件收发系统的难点不在界面而在两个容易被低估的地方一是SMTP/POP3/IMAP协议细节二是“收下来的邮件到底存成什么样”。很多组把时间花在页面上最后卡在附件解析和中文乱码上。这篇按“理论能讲清、代码能复现、数据库能落地”的顺序写最终落到一份可以直接核验字段和配置的源码检查清单上。2. 邮件收发系统的SSM选型与项目骨架搭建2.1 SSM三件套在邮件收发系统里分别承担什么SSM 是 Spring、SpringMVC、MyBatis 三个框架的缩写它们在邮件收发系统里各管一段边界很清楚组件职责在邮件系统里的落点Spring管理对象生命周期与事务邮件发送服务、接收服务、附件处理服务的Bean统一由容器托管SpringMVC处理HTTP请求与响应/mail/send、/mail/list、/mail/detail等地址映射到ControllerMyBatis数据库持久化用户、已收邮件、已发邮件、附件的增删改查毕设选SSM而不是直接上Spring Boot不是因为SSM更简单而是答辩时“配置”本身就是考点。Spring的依赖注入怎么生效、SpringMVC的DispatcherServlet在web.xml里怎么注册、MyBatis的Mapper接口怎么扫描这些问题是SSM项目的天然素材。我一般建议保留手写配置不要全部换成注解不然答辩时“框架整合过程”没法展开讲。2.2 源码的包结构怎么摆才算“成体系的SSM工程”常见的做法是用Maven建工程包名按业务竖切。下面这个结构适合邮件收发系统也容易被看出做过工程化思考ssm-mail/ ├── pom.xml ├── src/main/java/com/example/mail/ │ ├── controller/ # 邮件页面与操作入口 │ │ ├── MailSendController.java │ │ └── MailReceiveController.java │ ├── service/ # 业务层收发逻辑、附件落盘 │ │ ├── MailSendService.java │ │ ├── MailReceiveService.java │ │ └── impl/ │ ├── mapper/ # MyBatis Mapper接口 │ │ ├── UserMapper.java │ │ └── MailMapper.java │ ├── pojo/ # 数据库实体 │ │ ├── User.java │ │ ├── ReceivedMail.java │ │ └── SentMail.java │ ├── util/ # JavaMail封装、日期处理 │ │ ├── MailSenderUtil.java │ │ └── MailReceiverUtil.java │ └── config/ └── src/main/resources/ ├── jdbc.properties # 数据库连接参数 ├── spring-mybatis.xml # Spring与MyBatis整合 ├── spring-mvc.xml # SpringMVC扫描与视图解析 └── mapper/ # Mapper XML文件 ├── UserMapper.xml └── MailMapper.xml分层逻辑是Controller只管拿参数和返回视图Service负责组合JavaMail与数据库操作Mapper只接触SQL。包名里的util放JavaMail的封装类因为JavaMail本身不是Spring组件封装后交给Service调用更顺手。2.3 Spring与MyBatis整合配置里必须有的四个点spring-mybatis.xml是SSM项目的“地基”。一个能搜到邮件、能存邮件的配置至少包含四样东西数据源、SqlSessionFactory、Mapper扫描、事务管理器。核心片段如下context:property-placeholder locationclasspath:jdbc.properties/ bean iddataSource classcom.alibaba.druid.pool.DruidDataSource property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.example.mail.mapper/ /bean bean idtransactionManager classorg.springframework.jdbc.datasource.DataSourceTransactionManager property namedataSource refdataSource/ /beanmapperLocations指向XML文件目录basePackage指向Mapper接口所在包。“扫码收信后写库”这类操作同时涉及收件箱更新和邮件插入如果不做事务收信成功但入库失败时会出现“邮件丢了但不知情”的情况。数据源选Druid而不是默认的DriverManagerDataSource是为了拿监控页和连接池能力这在答辩时也能作为亮点提一句。写完后先用一个最简单的Controller验证容器能启动再往里面加邮件业务而不是一上来就把收发逻辑堆进去。3. 邮件协议工作方式与JavaMail收发核心实现3.1 SMTP、POP3、IMAP的协议分工怎么给答辩老师讲邮件收发不是一个Java方法从头做到尾中间隔着协议。发送统一走SMTP收件则分POP3和IMAP三者在邮件收发系统里的关系是协议全称端口SSL典型用途SMTPSimple Mail Transfer Protocol465 / 587把邮件从客户端推送到邮件服务器POP3Post Office Protocol 3995把邮件从服务器下载到本地服务器端通常删除原文IMAPInternet Message Access Protocol993客户端与服务器同步邮件状态服务器保留原邮件毕设推荐收件用IMAP原因很实际POP3把邮件取走后服务器就没了重复拉取会出现“第一遍收10封第二遍收0封”的效果不仅数据库难自圆其说演示时也容易翻车。IMAP可以用UID做增量同步同一个邮箱反复测试也不会重复入库。3.2 JavaMail的Maven依赖与连接参数授权码才是密码JavaMail不在Spring框架内需要单独引依赖。SSM项目大多跑在Java 8上用javax.mail1.6.2 最稳dependency groupIdjavax.mail/groupId artifactIdmail/artifactId version1.6.2/version /dependency然后要意识到一个高频翻车点新浪、QQ、网易等邮箱的SMTP/POP3/IMAP服务登录密码不是邮箱登录密码而是“授权码”。授权码在邮箱网页端的“设置—账户—IMAP/SMTP服务”里开启后生成。代码里props.put(mail.smtp.auth, true)必须配否则服务器会返回530 Authentication错误。3.3 发送邮件用MimeMessage组装一封带文本和附件的信这是源码里最常见的发送封装。下面这段覆盖了连接配置、收件人解析和带附件发送public void sendWithAttachment(String to, String subject, String content, String attachPath) throws MessagingException { // 1. 准备连接参数 Properties props new Properties(); props.put(mail.smtp.host, smtp.qq.com); props.put(mail.smtp.port, 465); props.put(mail.smtp.auth, true); props.put(mail.smtp.ssl.enable, true); // 465端口强制SSL // 2. 创建带授权码的会话 Session session Session.getInstance(props, new Authenticator() { Override protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication(senderqq.com, 授权码); } }); // 3. 构建邮件内容 MimeMessage message new MimeMessage(session); message.setFrom(new InternetAddress(senderqq.com)); message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to)); message.setSubject(subject, UTF-8); // 4. 文本与附件组装成multipart MimeMultipart multipart new MimeMultipart(); MimeBodyPart textPart new MimeBodyPart(); textPart.setText(content, UTF-8); multipart.addBodyPart(textPart); if (attachPath ! null !attachPath.isEmpty()) { MimeBodyPart attachPart new MimeBodyPart(); attachPart.attachFile(new File(attachPath)); multipart.addBodyPart(attachPart); } message.setContent(multipart); Transport.send(message); // 发送 }两个参数值得细说setSubject和setText都显式传了UTF-8否则中文标题在部分客户端里会变成乱码multipart的顺序是先文本后附件有的邮件客户端对只有附件的纯multipart解析很怪保留一个空文本段能规避异常。smtp.ssl.enabletrue只适用于465端口如果改成587端口需要用STARTTLS。3.4 接收邮件用IMAP协议按UID增量拉取收件箱接收相比发送更复杂因为要遍历Folder、判断邮件类型、还要处理“已经收过的不要再收”。可以基于IMAP的UIDFolder实现增量拉取public void receiveIncremental(String host, int port, String user, String authCode) throws Exception { Properties props new Properties(); props.put(mail.store.protocol, imap); props.put(mail.imap.host, host); props.put(mail.imap.port, String.valueOf(port)); props.put(mail.imap.ssl.enable, true); Session session Session.getInstance(props); Store store session.getStore(imap); store.connect(user, authCode); Folder folder store.getFolder(INBOX); FolderUID folderUid (FolderUID) folder; folder.open(Folder.READ_ONLY); // 从上次记录的最大UID开始拉取 int lastUid mailMapper.getLastUid(); UIDFolder uidFolder (UIDFolder) folder; Message[] messages uidFolder.getMessagesByUID(lastUid 1, UIDFolder.LASTUID); for (Message msg : messages) { long uid uidFolder.getUID(msg); String subject msg.getSubject(); String from InternetAddress.toString(msg.getFrom()); Object body msg.getContent(); if (body instanceof Multipart) { // 遍历bodyParttext/plain部分存正文其他部分存附件 Multipart mp (Multipart) body; for (int i 0; i mp.getCount(); i) { BodyPart part mp.getBodyPart(i); String disposition part.getDisposition(); if (Part.ATTACHMENT.equalsIgnoreCase(disposition)) { // 附件写入本地目录同时记录文件名 } else { // 正文文本存数据库 } } } mailMapper.insertReceivedMail(uid, from, subject, ...); } folder.close(false); store.close(); }folder.open(Folder.READ_ONLY)是故意用只读模式防止JavaMail把邮件标记为已读影响演示时刷新状态的判断。getMessagesByUID(lastUid 1, LASTUID)是增量同步的关键把上次最大的UID存到一张配置表或内存Map里下次启动就不会重复入库。注意FolderUID是笔误实际类型是UIDFolder二者含义不同判断附件时disposition可能为null此时要以part.getFileName() ! null作为兜底判断。4. 邮件收发系统的数据库设计与MyBatis持久化4.1 用户、邮件、附件三张核心表怎么建才能应对答辩追问邮件系统数据库不能只做一张“邮件表”。至少要拆出用户表、已收邮件表、已发邮件表和附件表。下面以收件箱为核心给出建表SQL字符集用utf8mb4因为它能存4字节Emoji表情邮件正文里出现这类字符很常见CREATE TABLE mail_user ( id INT PRIMARY KEY AUTO_INCREMENT, email VARCHAR(128) NOT NULL UNIQUE, password VARCHAR(255) NOT NULL, smtp_host VARCHAR(128), imap_host VARCHAR(128), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE received_mail ( id INT PRIMARY KEY AUTO_INCREMENT, uid BIGINT NOT NULL COMMENT IMAP的UID用于增量同步, user_id INT NOT NULL, from_address VARCHAR(128) NOT NULL, subject VARCHAR(512), content LONGTEXT, receive_time DATETIME, has_attachment TINYINT DEFAULT 0, read_flag TINYINT DEFAULT 0, UNIQUE KEY uk_user_uid (user_id, uid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE mail_attachment ( id INT PRIMARY KEY AUTO_INCREMENT, mail_id INT NOT NULL, file_name VARCHAR(255) NOT NULL, file_path VARCHAR(512) NOT NULL, file_size BIGINT ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;received_mail表有两个细节要在答辩时主动讲一是uid和user_id建了唯一索引uk_user_uid保证同一个邮箱账号下同一封邮件不会因重复拉取而插入两次二是content用LONGTEXT而不是VARCHAR(500)因为HTML邮件正文轻易超过几千字符用VARCHAR会被MySQL截断。mail_attachment并不直接存文件二进制只存文件路径。文件存服务器磁盘数据库只维护“哪封邮件有哪些附件”的映射关系否则数据库文件会迅速膨胀备份也很慢。4.2 Mapper.xml里邮件的动态SQL怎么写才不留漏洞MyBatis的优势在“动态SQL”。收件箱列表要按read_flag筛选搜索邮件要按subject模糊查询这些用Mapper XML写比拼接Java字符串清晰得多select idlistReceivedMail resultTypecom.example.mail.pojo.ReceivedMail SELECT id, uid, from_address, subject, receive_time, read_flag, has_attachment FROM received_mail where if testuserId ! null AND user_id #{userId} /if if testkeyword ! null and keyword ! AND (subject LIKE CONCAT(%, #{keyword}, %) OR from_address LIKE CONCAT(%, #{keyword}, %)) /if if testunreadOnly ! null and unreadOnly AND read_flag 0 /if /where ORDER BY receive_time DESC LIMIT #{offset}, #{pageSize} /selectwhere标签会自动去掉第一个AND这样三个条件任意组合不会拼出语法错误。LIMIT #{offset}, #{pageSize}是分页参数不要在Java层把全部邮件查出来再截取邮件量大时全表加载会把Tomcat内存耗尽。这里没有用PageHelper插件原因是毕设里手写分页更能展示对SQL的理解用插件反而容易被追问“底层怎么实现的”。4.3 数据库连接与表结构调整时容易被绕进去的坑在Navicat或命令行里调表结构前先确认jdbc.properties里的URL是否带了时区参数jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/ssm_mail?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456serverTimezoneAsia/Shanghai是MySQL 8.x的强制要求缺失时连接报The server time zone value异常。字符集参数characterEncodingutf8要与表的utf8mb4一致否则收下来的邮件入库后再查出来中文在页面与控制台之间反复横跳一会正常一会乱码。表结构改动后Mapper里对应的字段名要同步核对。MyBatis默认开启驼峰映射还要在配置里确认setting namemapUnderscoreToCamelCase valuetrue/否则数据库的from_address映射不到实体类的fromAddress属性运行时不报错但查询结果全是null这种问题最花时间。5. 高分答辩现场要验证的四件事从真实邮箱闭环到源码检查5.1 用两个真实邮箱跑通收发闭环开发完第一件事不是截图上交而是准备两个真实邮箱做端到端验证。常见的做法是拿QQ邮箱发到163邮箱再从163的IMAP收下来注意两个邮箱都要在设置里开启SMTP/IMAP服务并生成授权码。验证顺序固定为先发后收收的时候看控制台是否打印UID和水票字段再开QQ邮箱网页端确认对方邮件已到达。测试时不要用同一个邮箱给同一封邮件群发多遍邮箱服务商有发信频率限制连续快速发送会触发风控。每分钟发一封、连续发十封是安全的节奏。5.2 三个高频报错与对应处理方式报错关键词真实原因处理方式535 Authentication failed密码位用了邮箱登录密码而非授权码到邮箱设置里生成授权码替换jdbc.properties或常量里的对应值Connection timed out端口或SSL配置不一致465端口配ssl.enabletrue587端口配starttls.enabletrueMissing attachmentgetDisposition()返回null但文件名存在判断条件改为fileName ! null出现第一类报错时多数人第一反应是去看防火墙其实99%的情况就是授权码问题。5.3 源码里的三处加分自查项交付源码前检查这三个地方第一MailSenderUtil和MailReceiverUtil里的邮箱地址与授权码是否写在常量类中而不是散落在Controller里第二pom.xml中是否声明了Druid连接池依赖如果没有spring-mybatis.xml里的Druid类会直接启动报错第三resources/sql/目录下是否有建库建表脚本答辩翻源码演示时直接执行脚本能重建库这才算得上“源码数据库”完整交付。最后一个加分项是把IMAP接收封装成定时任务比如用Spring的Scheduled注解每三分钟拉取一次新邮件。这个功能在答辩演示时效果很直观网页端发一封邮件稍等片刻系统自动收到并入库比手动点击“收信”按钮更有冲击力。定时任务里给ReceiveService加一个synchronized锁避免上一次拉取还没结束下一次又启动重复消费同一批UID邮件。本文还有配套的精品资源点击获取