常见问题
Q: 项目报错找不到指定对象

A: 是因为MyBatis-Flex 使用了 APT(Annotation Processing Tool)技术,在项目编译的时候,会自动根据 Entity 类定义的字段帮你生成 "ACCOUNT" 类以及 Entity 对应的 Mapper 类, 通过开发工具构建项目(如下图),或者执行 maven 编译命令: mvn clean install 都可以自动生成。这个原理和 lombok 一致。

Q: 如何修改文件上传大小限制?
A: 需要在服务端的 application.yml 中修改 spring.servlet.multipart 相关配置,同时如果使用了 Nginx,也需要修改 client_max_body_size。
Q: 支持 HTTPS 吗?
A: 支持。建议通过 Nginx 配置 SSL 证书来实现 HTTPS 访问。
Q: 为什么分片上传速度慢?
A: 速度受限于网络带宽和存储平台的写入速度。建议检查 Redis 的响应速度以及并发上传的分片数。
Q: 邮件发送失败或收不到邮件怎么办?
A: 邮件功能需要配置 SMTP 服务器才能正常使用。请在 application.yml 中配置邮件服务器信息:
spring:
# 邮件配置
mail:
# 开关
enable: true
#smtp服务主机 qq邮箱则为smtp.qq.com
host: smtp.qq.com
#编码集
default-encoding: UTF-8
#发送邮件的账户, 改成你自己的
username: free-fs@qq.com
form: Free-Fs <free-fs@qq.com>
#授权码,去相关邮箱设置查询
password: xxxxxxxxxxxx
properties:
mail:
smtp:
ssl:
enable: true
socketFactory:
port: 465
class: javax.net.ssl.SSLSocketFactory
auth: true
starttls:
enable: true
required: true注意事项:
- 大多数邮箱需要使用授权码而非登录密码
- 检查防火墙是否允许 SMTP 端口
- 查看应用日志确认具体错误信息
- 测试时可以先发送给自己验证配置是否正确