\u524d\u8a00：<\/p>\n
\u8be5\u6587\u6863\u53ea\u4f5c\u4e3a\u672c\u4eba\u5b66\u4e60\u8fc7\u7a0b\u7684\u8bb0\u5f55，\u82e5\u8fd8\u9700\u8981\u66f4\u8be6\u7ec6\u7684\u9879\u76ee\u6587\u6863\u53ef\u4ee5\u70b9\u51fb\u4e0b\u65b9\u94fe\u63a5\u8fdb\u884c\u8d2d\u4e70<\/p>\n
\u6587\u6863\u5730\u5740<\/p>\n
\u540c\u65f6\u8be5\u9879\u76ee\u5df2\u7ecf\u5728git\u4e0a\u9762\u5f00\u6e90，\u53ef\u4ee5\u5728\u8d2d\u4e70\u524d\u53bb\u770b\u4e00\u4e0b\u8be5\u9879\u76ee\u3002<\/p>\n
\u9879\u76ee\u540e\u7aef\u7684git\u5730\u5740：\u77e5\u5149git\u540e\u7aef\u5730\u5740<\/p>\n
\u9879\u76ee\u524d\u7aef\u7684git\u5730\u5740: \u77e5\u5149git\u524d\u7aef\u5730\u5740<\/p>\n
\u7531\u4e8e\u672c\u4eba\u8fd8\u5728\u5f00\u53d1\u5b66\u4e60\u5f53\u4e2d\u5982\u679c\u8981\u770b\u672c\u4eba\u7684\u4ee3\u7801\u53ef\u4ee5\u8fdb\u5165\u4ee5\u4e0b\u5730\u5740：<\/p>\n
\u672c\u4eba\u7684gitee\u5730\u5740<\/p>\n
\u8be5\u6a21\u5757\u4ee3\u7801\u6211\u8003\u8651\u5230\u8ddf\u7528\u6237\u76f8\u5173，\u56e0\u6b64\u6211\u653e\u5728\u7528\u6237\u6a21\u5757\u4e0b\u7684\u5305\u5185<\/p>\n
package com.xiaoce.zhiguang.user.domain.dto;<\/p>\n
import jakarta.validation.constraints.PastOrPresent;
\nimport jakarta.validation.constraints.Pattern;
\nimport jakarta.validation.constraints.Size;<\/p>\n
import java.time.LocalDate;<\/p>\n
\/**
\n * ProfilePatchRequest
\n * <p>
\n * \u7528\u6237\u8d44\u6599\u6a21\u5757\u7684dto
\n * \u4f5c\u7528\u662f\u5728 \u524d\u7aef（App\/\u7f51\u9875） \u548c \u540e\u7aef \u4e4b\u95f4\u4f20\u9012\u7528\u6237\u60f3\u8981\u4fee\u6539\u7684\u4e2a\u4eba\u8d44\u6599\u6570\u636e\u3002
\n *
\n * @author \u5c0f\u7b56
\n * @date 2026\/1\/20 16:36
\n *\/
\npublic record ProfilePatchRequest(
\n @Size(min = 1, max = 64, message = "\u6635\u79f0\u957f\u5ea6\u9700\u5728 1-64 \u4e4b\u95f4") String nickname,<\/p>\n
@Size(max = 512, message = "\u4e2a\u4eba\u63cf\u8ff0\u957f\u5ea6\u4e0d\u80fd\u8d85\u8fc7 512") String bio,<\/p>\n
@Pattern(regexp = "(?i)MALE|FEMALE|OTHER|UNKNOWN", message = "\u6027\u522b\u53d6\u503c\u4e3a MALE\/FEMALE\/OTHER\/UNKNOWN") String gender,<\/p>\n
@PastOrPresent(message = "\u751f\u65e5\u4e0d\u80fd\u665a\u4e8e\u4eca\u5929") LocalDate birthday,<\/p>\n
@Pattern(regexp = "^[a-zA-Z0-9_]{4,32}$", message = "\u77e5\u5149\u53f7\u4ec5\u652f\u6301\u5b57\u6bcd\u3001\u6570\u5b57\u3001\u4e0b\u5212\u7ebf，\u957f\u5ea6 4-32") String zgId,<\/p>\n
@Size(max = 128, message = "\u5b66\u6821\u540d\u79f0\u957f\u5ea6\u4e0d\u80fd\u8d85\u8fc7 128") String school,<\/p>\n
String tagJson
\n) {
\n}
\npackage com.xiaoce.zhiguang.user.domain.vo;<\/p>\n
import com.xiaoce.zhiguang.user.domain.po.Users;<\/p>\n
import java.time.LocalDate;<\/p>\n
\/**
\n * ProfileResponse
\n * <p>
\n * \u7528\u6237\u8d44\u6599\u54cd\u5e94\u5bf9\u8c61 (VO)
\n * \u4f5c\u7528：\u540e\u7aef\u5c06\u6570\u636e\u5e93\u4e2d\u7684\u7528\u6237\u4fe1\u606f\u8131\u654f\u3001\u6574\u7406\u540e，\u8fd4\u56de\u7ed9\u524d\u7aef\u5c55\u793a\u3002
\n * \u5b83\u662f\u7528\u6237\u5728\u201c\u4e2a\u4eba\u4e2d\u5fc3\u201d\u6216\u201c\u4ed6\u4eba\u4e3b\u9875\u201d\u770b\u5230\u7684\u8d44\u6599\u89c6\u56fe\u3002
\n *
\n * @author \u5c0f\u7b56
\n * @date 2026\/1\/20 16:37
\n *\/
\npublic record ProfileResponse(
\n \/**
\n * \u7528\u6237\u552f\u4e00\u6807\u8bc6 ID
\n *\/
\n Long id,<\/p>\n
\/**
\n * \u7528\u6237\u6635\u79f0
\n *\/
\n String nickname,<\/p>\n
\/**
\n * \u5934\u50cf URL \u5730\u5740 (\u901a\u5e38\u662f OSS \u8bbf\u95ee\u94fe\u63a5)
\n *\/
\n String avatar,<\/p>\n
\/**
\n * \u4e2a\u4eba\u7b80\u4ecb\/\u7b7e\u540d
\n *\/
\n String bio,<\/p>\n
\/**
\n * \u77e5\u5149\u53f7 (\u7528\u6237\u81ea\u5b9a\u4e49\u7684\u552f\u4e00\u6807\u8bc6 ID)
\n *\/
\n String zgId,<\/p>\n
\/**
\n * \u6027\u522b (\u5982：MALE, FEMALE, OTHER, UNKNOWN)
\n *\/
\n String gender,<\/p>\n
\/**
\n * \u51fa\u751f\u65e5\u671f
\n *\/
\n LocalDate birthday,<\/p>\n
\/**
\n * \u5b66\u6821\/\u6559\u80b2\u80cc\u666f
\n *\/
\n String school,<\/p>\n
\/**
\n * \u7ed1\u5b9a\u624b\u673a\u53f7 (\u901a\u5e38\u4f1a\u505a\u63a9\u7801\u5904\u7406，\u5982 138****0000)
\n *\/
\n String phone,<\/p>\n
\/**
\n * \u7ed1\u5b9a\u90ae\u7bb1
\n *\/
\n String email,<\/p>\n
\/**
\n * \u7528\u6237\u6807\u7b7e (JSON \u683c\u5f0f\u5b57\u7b26\u4e32)
\n *\/
\n String tagJson
\n) {
\n \/**
\n * \u9759\u6001\u5de5\u5382\u65b9\u6cd5：\u5c06\u6570\u636e\u5e93 PO \u5bf9\u8c61\u5b89\u5168\u5730\u8f6c\u6362\u4e3a\u5c55\u793a\u7528\u7684 VO \u5bf9\u8c61
\n * @param user \u6570\u636e\u5e93 Users \u5b9e\u4f53
\n * @return \u8f6c\u6362\u540e\u7684 ProfileResponse
\n *\/
\n public static ProfileResponse fromEntity(Users user) {
\n if (user == null) return null;
\n return new ProfileResponse(
\n user.getId(),
\n user.getNickname(),
\n \/\/ \u5982\u679c\u5934\u50cf\u4e3a\u7a7a，\u8fd9\u91cc\u53ef\u4ee5\u5904\u7406\u9ed8\u8ba4\u503c
\n user.getAvatar() == null ?"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/01\/20260123084832-697335e02d09f.jpg" : user.getAvatar(),
\n user.getBio(),
\n user.getZgId(),
\n user.getGender(),
\n user.getBirthday(),
\n user.getSchool(),
\n \/\/ \u5728\u6b64\u5904\u8fdb\u884c\u624b\u673a\u53f7\u8131\u654f\u5904\u7406
\n maskPhone(user.getPhone()),
\n maskEmail(user.getEmail()),
\n user.getTagsJson()
\n );
\n }
\n private static String maskPhone(String phone) {
\n if (phone == null || phone.length() < 11) return phone;
\n return phone.replaceAll("(\\\\\\\\d{3})\\\\\\\\d{4}(\\\\\\\\d{4})", "$1****$2");
\n }<\/p>\n
private static String maskEmail(String email) {
\n if (email == null || !email.contains("@")) return email;
\n return email.replaceAll("(\\\\\\\\w).*(?=@)", "$1****");
\n }
\n} <\/p>\n
\u90a3\u8fd9\u662f\u65f6\u5019\u53c8\u6709\u95ee\u9898\u4e86，\u4e4b\u524d\u5728\u914d\u7f6e\u6a21\u5757\u4e2d\u5df2\u7ecf\u6709\u4e86SecurityConfig\u91cc\u9762\u6709\u4e2acorsConfigurationSource\u8fd9\u4e2aBean，\u4e3a\u4ec0\u4e48\u8fd9\u91cc\u53c8\u8981\u6709\u4e2aCorsConfig\u5462？\u80fd\u4e0d\u80fd\u76f4\u63a5\u5728\u8fd9\u4e2acorsConfigurationSource\u91cc\u9762\u505a\u4fee\u6539，\u4e0d\u5199\u914d\u7f6e\u7c7b\u5462？<\/p>\n
\u4e3b\u8981\u539f\u56e0\u662f\u56e0\u4e3a\u4f7f\u7528\u4e86PatchMapping\u8bf7\u6c42，\u8fd9\u662f\u4e00\u4e2a\u590d\u6742\u8bf7\u6c42\u4f1a\u89e6\u53d1 CORS \u9884\u68c0；\u4f1a\u5148\u53d1\u9001 OPTIONS \u9884\u68c0\u8bf7\u6c42\u3002\u5982\u679c\u540e\u7aef\u672a\u6b63\u786e\u914d\u7f6e CORS \u6216\u672a\u653e\u884c OPTIONS，\u8bf7\u6c42\u5c31\u4f1a\u88ab\u6d4f\u89c8\u5668\u62e6\u622a，\u63a5\u53e3\u5c31\u65e0\u6cd5\u8bf7\u6c42\u6210\u529f\u3002\u800c\u4e4b\u524d\u7684corsConfigurationSource\u5e76\u672a\u505a\u653e\u884c\u64cd\u4f5c\u3002<\/p>\n
\u5982\u679c\u53ea\u7528 SecurityConfig (\u6807\u51c6\u914d\u7f6e)：<\/p>\n
Spring Security \u7684\u8fc7\u6ee4\u5668\u94fe\u6761\u662f\u4e25\u683c\u6309\u987a\u5e8f\u6267\u884c\u7684\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b，\u5b83\u7684 \u9274\u6743\u8fc7\u6ee4\u5668 (AuthorizationFilter) \u5f80\u5f80\u6392\u5728 CORS\u8fc7\u6ee4\u5668 \u7684\u524d\u9762\u6216\u8005\u7d27\u6328\u7740\u3002<\/p>\n
\u800c\u5b9a\u4e49\u7684 CorsConfig \u7528\u4e86 Ordered.HIGHEST_PRECEDENCE，\u8fd9\u76f8\u5f53\u4e8e\u628a CORS \u5904\u7406\u63d0\u5230\u4e86\u5b89\u68c0\u95e8\u4e4b\u5916\u3002<\/p>\n
\u8bf7\u6c42\u8fdb\u6765：OPTIONS \u8bf7\u6c42\u5230\u8fbe\u670d\u52a1\u5668\u3002<\/p>\n
\u63a5\u5f85\u5458（\u4f60\u7684 CorsConfig）：<\/p>\n
\u5b89\u68c0\u5458（Security）：<\/p>\n
package com.xiaoce.zhiguang.user.config;<\/p>\n
import org.springframework.boot.web.servlet.FilterRegistrationBean;
\nimport org.springframework.context.annotation.Bean;
\nimport org.springframework.context.annotation.Configuration;
\nimport org.springframework.core.Ordered;
\nimport org.springframework.web.cors.CorsConfiguration;
\nimport org.springframework.web.cors.UrlBasedCorsConfigurationSource;
\nimport org.springframework.web.filter.CorsFilter;<\/p>\n
import java.util.List;<\/p>\n
\/**
\n * CorsConfig
\n * <p>
\n * \u5168\u5c40\u8de8\u57df\u914d\u7f6e\u7c7b
\n * \u91c7\u7528 Filter \u65b9\u6848，\u5728\u8bf7\u6c42\u8fdb\u5165 Servlet \u4e4b\u524d\u5904\u7406 CORS，\u4f18\u5148\u7ea7\u9ad8\u4e8e Spring Security
\n * @author \u5c0f\u7b56
\n * @date 2026\/1\/20 18:05
\n *\/
\n@Configuration
\npublic class CorsConfig {
\n @Bean
\n public FilterRegistrationBean<CorsFilter> corsFilterRegistration() {
\n \/\/ 1. \u521b\u5efa CORS \u914d\u7f6e\u5bf9\u8c61，\u7528\u4e8e\u5b9a\u4e49\u5177\u4f53\u7684\u8de8\u57df\u89c4\u5219
\n CorsConfiguration config = new CorsConfiguration();<\/p>\n
\/\/ \u5141\u8bb8\u7684\u6765\u6e90：\u4f7f\u7528 AllowedOriginPatterns \u652f\u6301\u901a\u914d\u7b26，\u5141\u8bb8\u6240\u6709\u7ad9\u70b9\u8de8\u57df\u8bf7\u6c42
\n \/\/ \u6ce8\u610f：\u751f\u4ea7\u73af\u5883\u4e0b\u5efa\u8bae\u8bbe\u7f6e\u4e3a\u5177\u4f53\u7684\u57df\u540d，\u5982 "https:\/\/www.zhiguang.com"
\n config.setAllowedOriginPatterns(List.of("*"));<\/p>\n
\/\/ \u5141\u8bb8\u7684 HTTP \u65b9\u6cd5：\u5fc5\u987b\u5305\u542b OPTIONS \u7528\u4e8e\u5904\u7406\u9884\u68c0\u8bf7\u6c42，PATCH \u7528\u4e8e\u5c40\u90e8\u66f4\u65b0
\n config.setAllowedMethods(List.of("GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"));<\/p>\n
\/\/ \u5141\u8bb8\u7684\u8bf7\u6c42\u5934：\u5141\u8bb8\u524d\u7aef\u5728 Header \u4e2d\u643a\u5e26 Authorization (\u5b58\u653e JWT) \u548c Content-Type \u7b49\u4fe1\u606f
\n config.setAllowedHeaders(List.of("*"));<\/p>\n
\/\/ \u662f\u5426\u5141\u8bb8\u643a\u5e26\u51ed\u8bc1：\u82e5\u524d\u7aef\u9700\u8981\u8de8\u57df\u53d1\u9001 Cookie，\u6b64\u9879\u5fc5\u987b\u4e3a true
\n \/\/ \u7531\u4e8e\u672c\u9879\u76ee\u76ee\u524d\u5c06 Refresh Token \u5b58\u5728 localStorage，\u6545\u8bbe\u4e3a false \u5373\u53ef
\n config.setAllowCredentials(false);<\/p>\n
\/\/ \u9884\u68c0\u8bf7\u6c42\u7684\u7f13\u5b58\u65f6\u95f4：\u5728\u6b64\u65f6\u95f4\u5185（1\u5c0f\u65f6），\u6d4f\u89c8\u5668\u4e0d\u518d\u9488\u5bf9\u76f8\u540c\u63a5\u53e3\u53d1\u9001 OPTIONS \u9884\u68c0，\u63d0\u5347\u6027\u80fd
\n config.setMaxAge(3600L);<\/p>\n
\/\/ 2. \u914d\u7f6e\u914d\u7f6e\u6e90：\u5c06\u4e0a\u8ff0\u89c4\u5219\u5e94\u7528\u5230\u5177\u4f53\u7684 URL \u8def\u5f84\u4e0a
\n UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();<\/p>\n
\/\/ \u9488\u5bf9 Profile \u6a21\u5757\u53ca Auth \u6a21\u5757\u7b49\u6240\u6709 API \u63a5\u53e3\u5f00\u542f\u8de8\u57df
\n source.registerCorsConfiguration("\/api\/v1\/**", config);<\/p>\n
\/\/ 3. \u6838\u5fc3：\u521b\u5efa Filter \u6ce8\u518c\u5bf9\u8c61，\u5e76\u8bbe\u7f6e\u6700\u9ad8\u4f18\u5148\u7ea7
\n FilterRegistrationBean<CorsFilter> bean = new FilterRegistrationBean<>(new CorsFilter(source));<\/p>\n
\/\/ \u8bbe\u7f6e\u6267\u884c\u987a\u5e8f\u4e3a\u6700\u9ad8\u4f18\u5148\u7ea7（Ordered.HIGHEST_PRECEDENCE）
\n \/\/ \u786e\u4fdd\u8de8\u57df\u5904\u7406\u53d1\u751f\u5728 Spring Security \u6743\u9650\u62e6\u622a\u4e4b\u524d，\u5f7b\u5e95\u89e3\u51b3\u9884\u68c0\u8bf7\u6c42\u88ab\u62e6\u622a\u7684\u95ee\u9898
\n bean.setOrder(Ordered.HIGHEST_PRECEDENCE);<\/p>\n
return bean;
\n }
\n} <\/p>\n
\u63a5\u53e3\u8be6\u60c5<\/p>\n
1.1 \u5c40\u90e8\u66f4\u65b0\u4e2a\u4eba\u8d44\u6599<\/p>\n
\u91c7\u7528 PATCH \u8bed\u4e49，\u4ec5\u63d0\u4ea4\u9700\u8981\u4fee\u6539\u7684\u5b57\u6bb5\u3002\u672a\u63d0\u4ea4\u7684\u5b57\u6bb5\u5728\u6570\u636e\u5e93\u4e2d\u4fdd\u6301\u4e0d\u53d8\u3002<\/p>\n
\u8bf7\u6c42\u53c2\u6570 (Body):<\/p>\n
\u54cd\u5e94\u793a\u4f8b (200 OK):<\/p>\n
JSON<\/p>\n
{
\n "id": 10086,
\n "nickname": "\u5c0f\u7b56",
\n "avatar": "https:\/\/oss…\/avatar.jpg",
\n "bio": "\u5199\u4ee3\u7801\u7684",
\n "zgId": "xiaoce_001",
\n "gender": "MALE",
\n "birthday": "2000-01-01",
\n "school": "\u8d64\u5cf0\u5b66\u9662",
\n "phone": "138****8888",
\n "email": "x****@example.com",
\n "tagJson": "[\\\\"Java\\\\", \\\\"\u540e\u7aef\\\\"]"
\n} <\/p>\n
1.2 \u66f4\u65b0\u7528\u6237\u5934\u50cf<\/p>\n
\u4e0a\u4f20\u56fe\u7247\u6587\u4ef6，\u540e\u7aef\u4f1a\u5c06\u5176\u5b58\u5165 OSS \u5e76\u81ea\u52a8\u540c\u6b65\u66f4\u65b0\u7528\u6237\u8868\u4e2d\u7684\u5934\u50cf\u5730\u5740\u3002<\/p>\n
\u8bf7\u6c42\u53c2\u6570 (Form-Data):<\/p>\n
\u54cd\u5e94\u793a\u4f8b (200 OK):<\/p>\n
JSON<\/p>\n
{
\n "id": 10086,
\n "nickname": "\u5c0f\u7b56",
\n "avatar": "https:\/\/oss-cn-shenzhen…\/new_avatar_uuid.png",
\n "bio": "\u5199\u4ee3\u7801\u7684",
\n …
\n} <\/p>\n
package com.xiaoce.zhiguang.user.controller;<\/p>\n
import com.xiaoce.zhiguang.Oss.service.Impl.OssStorageServiceImpl;
\nimport com.xiaoce.zhiguang.auth.service.impl.JwtServiceImpl;
\nimport com.xiaoce.zhiguang.user.domain.dto.ProfilePatchRequest;
\nimport com.xiaoce.zhiguang.user.domain.vo.ProfileResponse;
\nimport com.xiaoce.zhiguang.user.service.IUserProfileService;
\nimport io.swagger.v3.oas.annotations.Operation;
\nimport io.swagger.v3.oas.annotations.Parameter;
\nimport io.swagger.v3.oas.annotations.media.Content;
\nimport io.swagger.v3.oas.annotations.media.Schema;
\nimport io.swagger.v3.oas.annotations.responses.ApiResponse;
\nimport io.swagger.v3.oas.annotations.responses.ApiResponses;
\nimport io.swagger.v3.oas.annotations.tags.Tag;
\nimport jakarta.validation.Valid;
\nimport lombok.RequiredArgsConstructor;
\nimport org.springframework.http.MediaType;
\nimport org.springframework.security.core.annotation.AuthenticationPrincipal;
\nimport org.springframework.security.oauth2.jwt.Jwt;
\nimport org.springframework.validation.annotation.Validated;
\nimport org.springframework.web.bind.annotation.*;
\nimport org.springframework.web.multipart.MultipartFile;<\/p>\n
\/**
\n * ProfileController
\n * <p>
\n * \u7528\u6237\u7b80\u4ecb\u76f8\u5173\u4e1a\u52a1\u7684controller
\n *
\n * @author \u5c0f\u7b56
\n * @date 2026\/1\/20 16:44
\n *\/
\n@RestController
\n@Tag(name = "\u7528\u6237\u7b80\u4ecb\u6a21\u5757")
\n@RequestMapping("\/api\/v1\/profile")
\n@Validated
\n@RequiredArgsConstructor
\npublic class ProfileController {<\/p>\n
private final IUserProfileService profileService;
\n private final JwtServiceImpl jwtService;
\n private final OssStorageServiceImpl ossStorageService;<\/p>\n
\/**
\n * ATCH (\u5c40\u90e8\u4fee\u6539)
\n * \u64cd\u4f5c\u76ee\u6807: \u8d44\u6e90\u7684\u90e8\u5206\u5b57\u6bb5
\n * \u63d0\u4ea4\u8981\u6c42: \u53ea\u9700\u63d0\u4ea4\u60f3\u4fee\u6539\u7684\u5b57\u6bb5
\n * \u5e42\u7b49\u6027: \u901a\u5e38\u4e0d\u5e42\u7b49（\u53d6\u51b3\u4e8e\u5177\u4f53\u5b9e\u73b0）
\n * \u4f7f\u7528\u573a\u666f: \u53ea\u9700\u8981\u53d1\u4e00\u4e2a\u5934\u50cf URL \u6216\u6587\u4ef6\u5373\u53ef
\n *\/<\/p>\n
@PatchMapping
\n @Operation(
\n summary = "\u5c40\u90e8\u66f4\u65b0\u4e2a\u4eba\u8d44\u6599",
\n description = "\u91c7\u7528 PATCH \u8bed\u4e49，\u4ec5\u63d0\u4ea4\u9700\u8981\u4fee\u6539\u7684\u5b57\u6bb5（\u5982\u6635\u79f0\u3001\u7b80\u4ecb\u7b49）\u3002\u672a\u63d0\u4ea4\u7684\u5b57\u6bb5\u5728\u6570\u636e\u5e93\u4e2d\u4fdd\u6301\u4e0d\u53d8\u3002"
\n )
\n @ApiResponses({
\n @ApiResponse(responseCode = "200", description = "\u66f4\u65b0\u6210\u529f",
\n content = @Content(schema = @Schema(implementation = ProfileResponse.class))),
\n @ApiResponse(responseCode = "400", description = "\u53c2\u6570\u6821\u9a8c\u5931\u8d25\u6216\u4e1a\u52a1\u903b\u8f91\u9519\u8bef"),
\n @ApiResponse(responseCode = "401", description = "\u672a\u767b\u5f55\u6216 Token \u65e0\u6548")
\n })
\n public ProfileResponse patch(@AuthenticationPrincipal Jwt jwt,
\n @Valid @RequestBody ProfilePatchRequest request) {
\n long userId = jwtService.extractUserId(jwt);
\n return profileService.updateProfile(userId, request);
\n }<\/p>\n
@PostMapping(value = "\/avatar", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
\n @Operation(
\n summary = "\u66f4\u65b0\u7528\u6237\u5934\u50cf",
\n description = "\u4e0a\u4f20\u56fe\u7247\u6587\u4ef6，\u540e\u7aef\u4f1a\u5c06\u5176\u5b58\u5165 OSS \u5e76\u540c\u6b65\u66f4\u65b0\u7528\u6237\u8868\u4e2d\u7684\u5934\u50cf\u5730\u5740\u3002\u6ce8\u610f：\u8bf7\u6c42\u5934\u9700\u8bbe\u4e3a multipart\/form-data\u3002"
\n )
\n @ApiResponses({
\n @ApiResponse(responseCode = "200", description = "\u66f4\u65b0\u6210\u529f",
\n content = @Content(schema = @Schema(implementation = ProfileResponse.class))),
\n @ApiResponse(responseCode = "400", description = "\u6587\u4ef6\u8bfb\u53d6\u5931\u8d25\u6216\u683c\u5f0f\u4e0d\u6b63\u786e")
\n })
\n public ProfileResponse updateAvatar(
\n @AuthenticationPrincipal Jwt jwt,
\n @Parameter(description = "\u5934\u50cf\u6587\u4ef6\u6d41", required = true) @RequestPart("file") MultipartFile file
\n ) {
\n long userId = jwtService.extractUserId(jwt);
\n \/\/ 1. \u8c03\u7528 OSS \u57fa\u7840\u6a21\u5757\u4e0a\u4f20\u6587\u4ef6\u5e76\u83b7\u53d6 URL
\n String url = ossStorageService.updateAvatar(userId, file);
\n \/\/ 2. \u8c03\u7528\u7528\u6237\u4e1a\u52a1\u6a21\u5757\u66f4\u65b0\u6570\u636e\u5e93
\n return profileService.updateAvatar(userId, url);
\n }
\n} <\/p>\n
package com.xiaoce.zhiguang.user.service;<\/p>\n
import com.baomidou.mybatisplus.extension.service.IService;
\nimport com.xiaoce.zhiguang.user.domain.dto.ProfilePatchRequest;
\nimport com.xiaoce.zhiguang.user.domain.po.Users;
\nimport com.xiaoce.zhiguang.user.domain.vo.ProfileResponse;
\nimport jakarta.validation.Valid;<\/p>\n
\/**
\n * IUserProfileService
\n * <p>
\n * \u7528\u6237\u7b80\u4ecb\u76f8\u5173\u4e1a\u52a1\u63a5\u53e3
\n *
\n * @author \u5c0f\u7b56
\n * @date 2026\/1\/20 16:46
\n *\/
\npublic interface IUserProfileService extends IService<Users> {<\/p>\n
ProfileResponse updateProfile(long userId, @Valid ProfilePatchRequest request);<\/p>\n
ProfileResponse updateAvatar(long userId, String url);
\n} <\/p>\n
\u6682\u65f6\u65e0\u6cd5\u5728\u98de\u4e66\u6587\u6863\u5916\u5c55\u793a\u6b64\u5185\u5bb9<\/p>\n
\u6682\u65f6\u65e0\u6cd5\u5728\u98de\u4e66\u6587\u6863\u5916\u5c55\u793a\u6b64\u5185\u5bb9<\/p>\n
package com.xiaoce.zhiguang.user.service.impl;<\/p>\n
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
\nimport com.xiaoce.zhiguang.common.exception.BusinessException;
\nimport com.xiaoce.zhiguang.common.exception.ErrorCode;
\nimport com.xiaoce.zhiguang.user.domain.dto.ProfilePatchRequest;
\nimport com.xiaoce.zhiguang.user.domain.po.Users;
\nimport com.xiaoce.zhiguang.user.domain.vo.ProfileResponse;
\nimport com.xiaoce.zhiguang.user.mapper.UsersMapper;
\nimport com.xiaoce.zhiguang.user.service.IUserProfileService;
\nimport com.xiaoce.zhiguang.user.service.IUserService;
\nimport lombok.RequiredArgsConstructor;
\nimport org.springframework.stereotype.Service;
\nimport org.springframework.transaction.annotation.Transactional;
\nimport org.springframework.util.StringUtils;<\/p>\n
import java.time.LocalDateTime;<\/p>\n
\/**
\n * UserProfileServiceImpl
\n * <p>
\n * \u7528\u6237\u7b80\u4ecb\u76f8\u5173\u4e1a\u52a1\u5b9e\u73b0\u7c7b
\n *
\n * @author \u5c0f\u7b56
\n * @date 2026\/1\/20 16:47
\n *\/
\n@Service
\n@RequiredArgsConstructor
\npublic class UserProfileServiceImpl extends ServiceImpl<UsersMapper, Users> implements IUserProfileService{<\/p>\n
private final IUserService userService;<\/p>\n
\/**
\n * \u66f4\u65b0\u7528\u6237\u4e2a\u4eba\u8d44\u6599
\n * @param userId \u7528\u6237ID
\n * @param request \u5305\u542b\u9700\u8981\u66f4\u65b0\u7684\u4e2a\u4eba\u8d44\u6599\u5b57\u6bb5
\n * @return ProfileResponse \u66f4\u65b0\u540e\u7684\u7528\u6237\u4e2a\u4eba\u8d44\u6599\u54cd\u5e94\u5bf9\u8c61
\n * @throws BusinessException \u5f53\u7528\u6237\u4e0d\u5b58\u5728\u6216\u672a\u63d0\u4f9b\u4efb\u4f55\u66f4\u65b0\u5b57\u6bb5\u65f6\u629b\u51fa
\n *\/
\n @Override
\n @Transactional
\n public ProfileResponse updateProfile(long userId, ProfilePatchRequest request) {
\n \/\/ \u6839\u636e\u7528\u6237ID\u67e5\u8be2\u7528\u6237\u4fe1\u606f，\u5982\u679c\u4e0d\u5b58\u5728\u5219\u629b\u51fa\u5f02\u5e38
\n Users user = lambdaQuery().eq(Users::getId, userId).oneOpt().orElseThrow(
\n () -> new BusinessException(ErrorCode.IDENTIFIER_NOT_FOUND, "\u7528\u6237\u4e0d\u5b58\u5728"));
\n \/\/ \u81f3\u5c11\u8981\u63d0\u4ea4\u4e00\u4e2a\u5b57\u6bb5，\u5426\u5219\u5c5e\u4e8e\u65e0\u6548\u8bf7\u6c42
\n boolean hasAnyField = request.nickname() != null || request.bio() != null || request.gender() != null
\n || request.birthday() != null || request.zgId() != null || request.school() != null
\n || request.tagJson() != null;
\n if (!hasAnyField) {
\n throw new BusinessException(ErrorCode.BAD_REQUEST, "\u672a\u63d0\u4ea4\u4efb\u4f55\u66f4\u65b0\u5b57\u6bb5");
\n }
\n String zgId = user.getZgId();
\n if (zgId != null && !zgId.isBlank()) {
\n userService.existsByZgIdExceptId(zgId, userId);
\n }
\n \/\/ 2. \u6267\u884c\u52a8\u6001 SQL \u66f4\u65b0
\n boolean success = lambdaUpdate()
\n .eq(Users::getId, userId) \/\/ \u5b9a\u4f4d\u7528\u6237
\n \/\/ \u53ea\u6709\u5f53 request \u4e2d\u7684\u5b57\u6bb5\u4e0d\u4e3a null \u65f6，\u624d\u6267\u884c set \u66f4\u65b0
\n .set(request.nickname() != null, Users::getNickname, request.nickname())
\n .set(request.bio() != null, Users::getBio, request.bio())
\n .set(request.gender() != null, Users::getGender, request.gender())
\n .set(request.birthday() != null, Users::getBirthday, request.birthday())
\n .set(request.zgId() != null, Users::getZgId, request.zgId())
\n .set(request.school() != null, Users::getSchool, request.school())
\n .set(request.tagJson() != null, Users::getTagsJson, request.tagJson())
\n .set(Users::getUpdatedAt, LocalDateTime.now()) \/\/ \u8bb0\u5f55\u66f4\u65b0\u65f6\u95f4
\n .update();
\n if (!success) {
\n throw new BusinessException(ErrorCode.INTERNAL_ERROR, "\u4e2a\u4eba\u8d44\u6599\u66f4\u65b0\u5931\u8d25");
\n }
\n Users userUpdate = lambdaQuery().eq(Users::getId, userId).oneOpt().orElseThrow(
\n () -> new BusinessException(ErrorCode.IDENTIFIER_NOT_FOUND, "\u7528\u6237\u4e0d\u5b58\u5728"));
\n return ProfileResponse.fromEntity(userUpdate);
\n }<\/p>\n
\/**
\n * \u66f4\u65b0\u7528\u6237\u5934\u50cf\u4fe1\u606f
\n * \u8be5\u65b9\u6cd5\u4f7f\u7528\u4e8b\u52a1\u6ce8\u89e3，\u786e\u4fdd\u64cd\u4f5c\u7684\u539f\u5b50\u6027
\n *
\n * @param userId \u7528\u6237ID
\n * @param url \u65b0\u7684\u5934\u50cfURL\u5730\u5740
\n * @return ProfileResponse \u5305\u542b\u66f4\u65b0\u540e\u7528\u6237\u4fe1\u606f\u7684\u54cd\u5e94\u5bf9\u8c61
\n * @throws BusinessException \u5f53\u7528\u6237\u4e0d\u5b58\u5728\u3001\u5934\u50cf\u94fe\u63a5\u4e3a\u7a7a\u3001\u683c\u5f0f\u4e0d\u5408\u6cd5\u6216\u66f4\u65b0\u5931\u8d25\u65f6\u629b\u51fa
\n *\/
\n @Override
\n @Transactional
\n public ProfileResponse updateAvatar(long userId, String url) {
\n \/\/ \u6839\u636e\u7528\u6237ID\u67e5\u8be2\u7528\u6237\u4fe1\u606f，\u5982\u679c\u7528\u6237\u4e0d\u5b58\u5728\u5219\u629b\u51fa\u5f02\u5e38
\n Users user = lambdaQuery().eq(Users::getId, userId).oneOpt().orElseThrow(() ->
\n new BusinessException(ErrorCode.IDENTIFIER_NOT_FOUND, "\u7528\u6237\u4e0d\u5b58\u5728"));
\n \/\/ \u68c0\u67e5\u5934\u50cf\u94fe\u63a5\u662f\u5426\u4e3a\u7a7a
\n if (!StringUtils.hasText(url)) {
\n throw new BusinessException(ErrorCode.BAD_REQUEST, "\u5934\u50cf\u94fe\u63a5\u4e0d\u80fd\u4e3a\u7a7a");
\n }
\n \/\/ \u7b80\u5355\u7684\u6b63\u5219：\u5fc5\u987b\u4ee5 http(s) \u5f00\u5934，\u901a\u5e38\u4ee5\u5e38\u89c1\u56fe\u7247\u540e\u7f00\u7ed3\u675f
\n String regex = "^(https?|ftp):\/\/[^\\\\\\\\s\/$.?#].[^\\\\\\\\s]*$";
\n if (!url.matches(regex)) {
\n throw new BusinessException(ErrorCode.BAD_REQUEST, "\u5934\u50cf\u94fe\u63a5\u683c\u5f0f\u4e0d\u5408\u6cd5");
\n }
\n boolean success = lambdaUpdate().eq(Users::getId, userId).set(Users::getAvatar, url).update();
\n if (!success) {
\n throw new BusinessException(ErrorCode.INTERNAL_ERROR, "\u5934\u50cf\u66f4\u65b0\u5931\u8d25");
\n }
\n Users userUpdate = this.getBaseMapper().selectById(user.getId());
\n return ProfileResponse.fromEntity(userUpdate);
\n }
\n}<\/p>\n","protected":false},"excerpt":{"rendered":"
\u524d\u8a00：
\n\u8be5\u6587\u6863\u53ea\u4f5c\u4e3a\u672c\u4eba\u5b66\u4e60\u8fc7\u7a0b\u7684\u8bb0\u5f55，\u82e5\u8fd8\u9700\u8981\u66f4\u8be6\u7ec6\u7684\u9879\u76ee\u6587\u6863\u53ef\u4ee5\u70b9\u51fb\u4e0b\u65b9\u94fe\u63a5\u8fdb\u884c\u8d2d\u4e70
\n\u6587\u6863\u5730\u5740
\n\u540c\u65f6\u8be5\u9879\u76ee\u5df2\u7ecf\u5728git\u4e0a\u9762\u5f00\u6e90，\u53ef\u4ee5\u5728\u8d2d\u4e70\u524d\u53bb\u770b\u4e00\u4e0b\u8be5\u9879\u76ee\u3002
\n\u9879\u76ee\u540e\u7aef\u7684git\u5730\u5740：\u77e5\u5149git\u540e\u7aef\u5730\u5740
\n\u9879\u76ee\u524d\u7aef\u7684git\u5730\u5740: \u77e5\u5149git\u524d\u7aef\u5730\u5740
\n\u7531\u4e8e\u672c\u4eba\u8fd8\u5728\u5f00\u53d1\u5b66\u4e60\u5f53\u4e2d\u5982\u679c\u8981\u770b\u672c\u4eba\u7684\u4ee3\u7801\u53ef\u4ee5\u8fdb\u5165\u4ee5\u4e0b\u5730\u5740：
\n\u672c\u4eba\u7684gitee\u5730\u5740
\n1 \u7528\u6237\u8d44\u6599\u6a21\u5757\u7684\u5b9e\u73b0
\n1.1 \u51c6\u5907\u7528\u6237\u8d44\u6599\u6a21\u5757\u6570\u636e\u4f20\u8f93\u9700\u8981<\/p>\n","protected":false},"author":2,"featured_media":64482,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[99,1769,101,292],"topic":[],"class_list":["post-64483","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-server","tag-java","tag-mybatis","tag-spring","tag-292"],"yoast_head":"\n