{"id":23150624,"url":"https://github.com/neutron123ab/user-match-backend","last_synced_at":"2026-04-12T18:44:01.233Z","repository":{"id":168107856,"uuid":"619420568","full_name":"neutron123ab/user-match-backend","owner":"neutron123ab","description":null,"archived":false,"fork":false,"pushed_at":"2023-04-05T13:28:30.000Z","size":145,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-10T00:37:56.958Z","etag":null,"topics":["java","mysql","redis","redisson","springboot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/neutron123ab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-27T05:31:04.000Z","updated_at":"2023-04-05T13:29:22.000Z","dependencies_parsed_at":"2023-06-13T06:30:49.545Z","dependency_job_id":null,"html_url":"https://github.com/neutron123ab/user-match-backend","commit_stats":null,"previous_names":["neutron123ab/user-match-backend"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neutron123ab%2Fuser-match-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neutron123ab%2Fuser-match-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neutron123ab%2Fuser-match-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neutron123ab%2Fuser-match-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/neutron123ab","download_url":"https://codeload.github.com/neutron123ab/user-match-backend/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247198431,"owners_count":20900079,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","mysql","redis","redisson","springboot"],"created_at":"2024-12-17T18:17:56.094Z","updated_at":"2026-04-12T18:43:56.191Z","avatar_url":"https://github.com/neutron123ab.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 用户匹配系统\n## 项目介绍：\n帮助大家找到志同道合的伙伴，包括用户注册登录、更新个人信息、按标签搜索用户、推荐相似用户、组队、聊天室等功能\n\n## 需求分析\n1. 用户自己添加标签，对标签分类\n2. 用户可编辑个人信息\n3. 允许用户根据标签去搜索其他用户\n4. 组队（创建队伍、加入队伍、根据标签检索队伍、邀请别人加入队伍、队长踢出队伍）\n5. 向用户推荐队伍/其他用户（相似度匹配算法）\n6. 队伍中的用户可群聊\n\n## 技术栈\n\n### 前端\n\n1. Vue3\n2. Vant UI\n3. Vite\n\n### 后端\n\n1. SpringBoot\n2. MySQL\n3. Redis\n4. WebSocket\n5. knife4j\n6. Redisson分布式锁\n7. 并发\n8. Spring Schedule 定时任务\n\n## 设计\n\n### 整合 Knife4j 接口文档\n\n在配置文件中添加`@Profile({\"dev\"})`注解，让该接口文档只有在本地开发环境下才能够被访问\n\n### 数据库表设计\n\n本来想要增加一张标签表，专门存储标签数据，但这样的话又要增加一张标签和用户的关联表，需要在多处联表查询。所以这里直接在用户表中增加一个字段，以 json 格式存储标签数据（使用mysql中的 json 数据类型，保存一个 json 数组）\n\n由于前端页面需要根据标签来选择数据，这里还是增加了一张标签表，但并不与用户表关联，只用与查找系统中有哪些标签，如果这个功能交给用户表完成的话，需要遍历所有用户找出不相同的标签，开销会很大。而且由于用户标签大多数情况都是不变的，所以后面可以直接在缓存中查找数据。\n\n#### 用户表\n\n```sql\n-- auto-generated definition\ncreate table user\n(\n    id            bigint auto_increment comment 'id'\n        primary key,\n    username      varchar(256)                       null comment '用户昵称',\n    user_account  varchar(256)                       null comment '账号',\n    avatar_url    varchar(1024)                      null comment '用户头像',\n    gender        tinyint                            null comment '性别',\n    user_password varchar(512)                       not null comment '密码',\n    phone         varchar(128)                       null comment '电话',\n    email         varchar(512)                       null comment '邮箱',\n    user_status   int      default 0                 not null comment '状态 0 - 正常',\n    create_time   datetime default CURRENT_TIMESTAMP not null comment '创建时间',\n    update_time   datetime default CURRENT_TIMESTAMP null on update CURRENT_TIMESTAMP comment '更新时间',\n    is_delete     tinyint  default 0                 not null comment '是否删除',\n    user_role     tinyint  default 0                 null comment '用户角色 0 - 普通用户 1 - 管理员',\n    tags          json                               null comment '标签 json 列表'\n)\n    comment '用户表';\n```\n\n#### 标签表\n\n```sql\ncreate table tags\n(\n    id          bigint auto_increment primary key,\n    tag_name    varchar(256)                       not null comment '标签名',\n    create_time datetime default CURRENT_TIMESTAMP not null comment '创建时间',\n    update_time datetime default CURRENT_TIMESTAMP not null on update CURRENT_TIMESTAMP comment '更新时间',\n    is_delete   tinyint  default 0                 not null comment '逻辑删除',\n    constraint tag_name\n        unique (tag_name)\n)\n    comment '标签表';\n```\n\n\n\n#### 队伍表\n\nid、队名、描述、队伍最大人数、队伍过期时间、队长id、队伍状态（公开、私有、加密）、密码（加密时才需要）、创建时间、更新时间、是否删除\n\n```sql\n-- auto-generated definition\ncreate table team\n(\n    id               bigint auto_increment primary key,\n    team_name        varchar(256)                       not null comment '队伍名称',\n    team_description varchar(1024)                      null comment '描述',\n    expire_time      datetime                           null comment '过期时间',\n    captain_id       bigint                             not null comment '队长id',\n    team_status      tinyint  default 0                 not null comment '队伍状态（0 公开，1 私有，2 加密）',\n    team_password    varchar(512)                       null comment '入队密码',\n    create_time      datetime default CURRENT_TIMESTAMP not null comment '创建时间',\n    update_time      datetime default CURRENT_TIMESTAMP not null on update CURRENT_TIMESTAMP comment '更新时间',\n    is_delete        int      default 0                 not null comment '是否删除（逻辑删除）'\n)\n    comment '队伍';\n```\n\n#### 用户队伍关联表\n\nid、用户id、队伍id、加入时间、创建时间、更新时间、是否删除\n\n```sql\n-- auto-generated definition\ncreate table user_team\n(\n    id          bigint auto_increment primary key,\n    user_id     bigint                             not null comment '用户id',\n    team_id     bigint                             not null comment '队伍id',\n    join_time   datetime                           null comment '用户加入时间',\n    create_time datetime default CURRENT_TIMESTAMP not null comment '创建时间',\n    update_time datetime default CURRENT_TIMESTAMP not null on update CURRENT_TIMESTAMP comment '更新时间',\n    is_delete   int      default 0                 not null comment '是否删除'\n)\n    comment '用户队伍关系';\n```\n\n\n\n### 后端接口开发\n\n#### 根据标签搜索用户\n\n用户可以传入多个标签，当这些标签都存在时才能搜索出用户\n\n这里有两种查找方式：\n\n1. 通过 sql 在数据库中查找，直接得到结果\n2. 内存查找\n\n#### 增加了mybatis数据类型转换器\n\n由于user表中保存了关于标签的json列表数据，所以我们每次取数据的时候都要多写一段反序列化的代码，为了增加复用，我自定义了一个`json转Set\u003cString\u003e`的`TypeHandler`并将其以注解的形式定义在实体类的json字段上（要在配置文件中注册这个`TypeHandler`），之后每次取数据的时候，它都会自动帮我把json数据以`Set\u003cString\u003e`的形式注入到tags字段中。\n\n**json与Set\\\u003cString\u003e的类型转换器**\n\n继承BaseTypeHandler类，重写其中的四个方法，把json序列化和反序列化的操作放到了这里面。\n\n```java\npublic class StringSetTypeHandler extends BaseTypeHandler\u003cSet\u003cString\u003e\u003e {\n\n    @Override\n    public void setNonNullParameter(PreparedStatement preparedStatement, int i, Set\u003cString\u003e strings, JdbcType jdbcType) throws SQLException {\n        Gson gson = new Gson();\n        String content = CollectionUtils.isEmpty(strings) ? null : gson.toJson(strings);\n        preparedStatement.setString(i, content);\n    }\n\n    @Override\n    public Set\u003cString\u003e getNullableResult(ResultSet resultSet, String s) throws SQLException {\n        Gson gson = new Gson();\n        String string = resultSet.getString(s);\n        return StringUtils.isBlank(string) ? new HashSet\u003c\u003e() : gson.fromJson(string, new TypeToken\u003cSet\u003cString\u003e\u003e() {}.getType());\n    }\n\n    @Override\n    public Set\u003cString\u003e getNullableResult(ResultSet resultSet, int i) throws SQLException {\n        Gson gson = new Gson();\n        String string = resultSet.getString(i);\n        return StringUtils.isBlank(string) ? new HashSet\u003c\u003e() : gson.fromJson(string, new TypeToken\u003cSet\u003cString\u003e\u003e() {}.getType());\n    }\n\n    @Override\n    public Set\u003cString\u003e getNullableResult(CallableStatement callableStatement, int i) throws SQLException {\n        Gson gson = new Gson();\n        String string = callableStatement.getString(i);\n        return StringUtils.isBlank(string) ? new HashSet\u003c\u003e() : gson.fromJson(string, new TypeToken\u003cSet\u003cString\u003e\u003e() {}.getType());\n    }\n}\n```\n\n之后将该`TypeHandler`注册\n\n```yaml\nmybatis-plus:\n\t# 扫描自定义TypeHandler所在包\n    type-handlers-package: com.neutron.usermatchbackend.handler\n```\n\n最后再实体类的tags字段上标注`TypeHandler`即可\n\n```java\n@TableField(value = \"tags\", typeHandler = StringSetTypeHandler.class)\nprivate Set\u003cString\u003e tags;\n```\n\n#### 更新用户信息\n\n用户登录后，用户信息就会存储在前端的pinia中，更新操作会修改pinia中的user状态，用户修改了信息后，会将该参数传递过来，后端用User实体类接收，根据id修改。\n\n#### 用户上传头像\n\n前端上传图片（要更改请求头），后端使用`MutipartFile`接收，随后调用腾讯云cos的SDK来上传图片到腾讯云图床。要使用腾讯云的SDK就必须在代码中配置id、key和SessionToken，我是用一个定时任务每隔两小时执行一次，生成临时的密钥。\n\n由于这里的定时任务只需要生成三个数据，并且为了安全性考虑都保存在本地的IOC容器中，所以没考虑用分布式锁。\n\n#### 分页展示用户数据\n\n使用mybatis的分页插件，前端每次都要传递页号与页面大小\n\n#### 推荐与用户兴趣最相似的用户\n\n根据用户表中的标签来进行匹配，这里使用的是编辑距离算法（字符串1经过多少次增删改字符操作可以变成字符串2，操作最少的用户即即为最匹配的用户）\n\n将编辑距离算法更改为如下形式：\n\n* 方法传递两个参数，一个是当前登录用户的标签列表，另一个是要比较的用户的标签列表\n* 先对两个列表排序（按首字母排序，如果首字符相同则按后面的字符排序，可以使用java8 stream的sorted方法），如果列表没有排序的话有可能出现两个用户的标签内容相同但顺序不同，结果相似度就非常低的情况\n* 比较两个列表中的字符串\n\n具体流程如下：\n\n1. 先获取表中所有的用户（只查id和tags两个字段）\n2. 用当前登录用户的tags与其它所有用户的tags比较，执行编辑距离算法，比较完成后将用户id与相似度存放到一个Pair结构中，让后将pair再存放入List集合\n3. 对上面的List结合中的所有pair以相似度大小进行排序，得到只包含用户id的list集合\n4. 根据上面的排好序的list集合去查找对应用户\n5. 获得用户信息后再根据前面得到的排好序的idList对用户进行排序，可以通过steam的skip和limit对用户进行分页操作，最后返回结果。\n\n#### 获取所有标签\n\n先从redis中取，取不到就取查数据库，再将数据加入缓存\n\n#### 用户上传标签\n\n如果用户上传的标签已存在于数据库中，则不添加。判断标签是否存在于数据库中的操作可以转到redis中进行，使用redis的set集合，如果redis中已存在该标签，就不操作数据库，否则先数据库中添加信息。因为这个数据变化不频繁，我设置过期时间为1小时\n\n#### 用户创建队伍\n\n要对传入的数据进行校验\n\n#### 队长或系统管理员修改队伍信息\n\n先判断传入的数据是否正常，在判断当前队伍的状态，如果当前队伍是加密的，那么传入的密码就不能为空\n\n#### 根据id查找队伍\n\n#### 查询队伍\n\n由于查询队伍可以有多种方式，例如：根据一个队伍id来查、根据多个id同时查找多个队伍、根据队名来查、根据队伍描述来查、根据队伍人数来查等等，这里可以把这些查询方式全部组合到一起，只对外提供一个接口就可以完成全部功能。\n\n要先增加返回给前端的`TeamUserVO`，该类中包含队伍信息、创建人信息和加入用户的id。前端识别当前登录用户是否为队伍创建人，如果不是，则不展示更新队伍按钮和删除队伍按钮，并且判断该用户是否已经加入了该队伍，如果已经加入，则展示退出队伍按钮，否则展示加入队伍按钮。\n\n#### 加入队伍\n\n为避免高并发情况下多个用户同时加入队伍导致加入人数超过限制的情况，需要在加入队伍前获取分布式锁，加入队伍完成后再释放锁\n\n#### 退出队伍\n\n如果队伍中只有一人，则直接删除队伍，否则将队长身份移交给第二个加入的用户\n\n#### 删除队伍\n\n### 全局登录校验拦截器\n\n要对knife4j文档放行\n\n### 缓存预热\n\n使用定时任务，每天的某个时间点加载缓存，但需要加锁，因为如果不加锁的话在多机部署的情况下所有机器都会去加载缓存，但实际上我们只需要一台机器加载缓存就能得到想要的结果。\n\n### 聊天室\n\n使用`spring-boot-starter-websocket`通过注解的方式实现实时通信\n\n### 批量导入100万条数据\n\n1. 每次导入1条数据，导入100万次（这种方式程序执行时间过长，且由于数据量很大，程序会变得不可控）\n2. 批量导入数据，将100万条数据分成很多组，每次导入一组（我这里每组设置10000条数据）\n\n![image-20230329144851789](D:\\zProject\\图片\\README\\image-20230329144851789.png)\n\n​\t用时156秒\n\n3. 通过多线程并发插入数据（我这里开了100个线程，每个线程处理10000条数据，需要配置数据库连接池的最大连接数，否则会报错）\n\n![image-20230329151817848](D:\\zProject\\图片\\README\\image-20230329151817848.png)\n\n​\t耗时45秒\n\n```java\n@Slf4j\n@Component\npublic class InsertUsers {\n\n    private final ExecutorService executorService = new ThreadPoolExecutor(100, 1000, 10000, TimeUnit.MINUTES, new ArrayBlockingQueue\u003c\u003e(10000));\n    /**\n     * 并发插入数据\n     */\n    public void insertUsersConcurrent() {\n        StopWatch stopWatch = new StopWatch();\n        stopWatch.start();\n        int j = 0;\n        List\u003cCompletableFuture\u003cVoid\u003e\u003e futureList = new ArrayList\u003c\u003e();\n        for (int i = 0; i \u003c 100; i++) {\n            List\u003cUser\u003e userList = new ArrayList\u003c\u003e();\n            while(true) {\n                j++;\n                User user = getUser();//设置要插入数据的信息\n                userList.add(user);\n                if(j % 10000 == 0) {\n                    break;\n                }\n            }\n            //异步执行\n            CompletableFuture\u003cVoid\u003e future = CompletableFuture.runAsync(() -\u003e {\n                userService.saveBatch(userList, 10000);\n            }, executorService);\n            futureList.add(future);\n        }\n        CompletableFuture.allOf(futureList.toArray(new CompletableFuture[]{})).join();\n        stopWatch.stop();\n        System.out.println(\"execute time(concurrent): \" + stopWatch.getTotalTimeMillis());\n    }\n\n}\n```\n\n### 性能优化\n\n\n\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneutron123ab%2Fuser-match-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneutron123ab%2Fuser-match-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneutron123ab%2Fuser-match-backend/lists"}