Free FS LogoFree FS

常见问题

Q: 项目报错找不到指定对象

QA1_1

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

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

注意事项:

  1. 大多数邮箱需要使用授权码而非登录密码
  2. 检查防火墙是否允许 SMTP 端口
  3. 查看应用日志确认具体错误信息
  4. 测试时可以先发送给自己验证配置是否正确

目录