Auth0生成带|的userId致Spring Boot接口请求报错，求解决方案

方案1：配置Tomcat允许特殊字符 #

Spring Boot内嵌的Tomcat默认严格遵循RFC 7230/3986规范，禁止|这类字符出现在请求路径中。你可以通过配置放宽限制：

• 在application.properties中添加：

server.tomcat.relaxed-path-chars=|
server.tomcat.relaxed-query-chars=|

• 或在application.yml中配置：

server:
  tomcat:
    relaxed-path-chars: '|'
    relaxed-query-chars: '|'

⚠️ 注意：此方案会小幅降低安全性，仅建议在确认这些字符不会引发注入风险的场景下使用。

方案2：修改Auth0的userId格式 #

Auth0支持通过**规则（Rules）**自定义用户ID生成逻辑，直接替换掉userId中的竖线：
在Auth0控制台添加如下规则代码：

function (user, context, callback) {
  // 将userId里的竖线替换为下划线（或其他合法字符）
  user.user_id = user.user_id.replace('|', '_');
  callback(null, user, context);
}

这样后续生成的userId将不再包含|，从根源解决问题，只要前后端统一使用替换后的ID即可。

方案3：前端编码+后端解码 #

让前端发起请求前对userId做URL编码（将|转成%7C），后端接收后再解码：

• 前端示例（JavaScript）：

const userId = 'service/google-oauth2|114309183689720156358';
const encodedUserId = encodeURIComponent(userId);
fetch(`/api/v1/user/${encodedUserId}`);

• 后端Spring Boot处理：

@GetMapping("/user/{userId}")
public ResponseEntity<User> getUser(@PathVariable String userId) {
    String decodedUserId = URLDecoder.decode(userId, StandardCharsets.UTF_8);
    // 使用解码后的ID查询用户
    return ResponseEntity.ok(userService.getUserById(decodedUserId));
}

此方案无需修改服务器或Auth0配置，但需要前后端配合调整。

方案4：调整接口设计，改用请求参数 #

把路径变量改成查询参数，特殊字符不会触发Tomcat的路径校验：

• 修改后端接口：

@GetMapping("/user")
public ResponseEntity<User> getUser(@RequestParam String userId) {
    return ResponseEntity.ok(userService.getUserById(userId));
}

• 前端请求URL变为：/api/v1/user?userId=service/google-oauth2|114309183689720156358
  这种方式完全符合HTTP规范，安全性最高，推荐优先考虑。

内容的提问来源于stack exchange，提问作者Leon