spring boot 全局异常处理捕获多租户隔离异常的核心做法是:在自定义的 `tenantcontext` 中通过 threadlocal 存储当前租户标识,并在业务逻辑或拦截器中根据该标识进行数据源路由或权限校验;当校验失败时抛出特定的 `tenantexception`(如 tenantnotfoundexception),然后在实现了 `@controlleradvice` 的全局异常处理器中专门捕获该异常并返回统一的错误响应。这样可以将租户相关的错误与其他系统异常区分开,确保前端能准确识别问题。

如何定义多租户上下文与隔离异常类
首先需要明确多租户数据的来源和隔离方式。通常我们使用 ThreadLocal 来保存当前请求的租户 ID,例如从 HTTP Header 中提取 tenant_id。如果租户不存在或无权访问,应抛出自定义的运行时异常。这个异常类需要包含租户 ID 和错误信息,以便后续处理。
package com.example.multitenant.exception;
public class TenantException extends RuntimeException {
private final String tenantId;
public TenantException(String tenantId, String message) {
super(message);
this.tenantId = tenantId;
}
public String getTenantId() {
return tenantId;
}
}
同时,需要一个工具类来管理这个上下文:
package com.example.multitenant.context;
public class TenantContext {
private static final ThreadLocal<string> CURRENT_TENANT = new ThreadLocal();
public static void setTenantId(String tenantId) {
CURRENT_TENANT.set(tenantId);
}
public static String getTenantId() {
return CURRENT_TENANT.get();
}
public static void clear() {
CURRENT_TENANT.remove();
}
}</string>
在 Controller 或 Service 中,我们可以模拟一个检查租户存在的逻辑:
package com.example.multitenant.service;
import com.example.multitenant.context.TenantContext;
import com.example.multitenant.exception.TenantException;
import org.springframework.stereotype.Service;
@Service
public class TenantService {
// 模拟已注册的租户列表
private static final String[] VALID_TENANTS = {"tenant1", "tenant2", "tenant3"};
public void validateTenant() {
String tenantId = TenantContext.getTenantId();
if (tenantId == null || !isValid(tenantId)) {
throw new TenantException(tenantId, "Invalid or missing tenant ID");
}
}
private boolean isValid(String tenantId) {
for (String valid : VALID_TENANTS) {
if (valid.equals(tenantId)) {
return true;
}
}
return false;
}
}
如何在全局异常处理器中捕获并响应租户异常
接下来,我们需要创建一个全局异常处理器,使用 `@RestControllerAdvice` 注解。在这个处理器中,编写一个方法专门处理 `TenantException`。该方法将返回一个标准的 JSON 响应,包含错误码、消息以及可选的租户 ID。
package com.example.multitenant.config;
import com.example.multitenant.exception.TenantException;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(TenantException.class)
@ResponseStatus(HttpStatus.BAD_REQUEST)
public Map<string object> handleTenantException(TenantException ex) {
Map<string object> body = new HashMap();
body.put("error", "TENANT_ERROR");
body.put("message", ex.getMessage());
body.put("tenantId", ex.getTenantId());
return body;
}
@ExceptionHandler(Exception.class)
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
public Map<string object> handleGenericException(Exception ex) {
Map<string object> body = new HashMap();
body.put("error", "INTERNAL_ERROR");
body.put("message", "An unexpected error occurred");
return body;
}
}</string></string></string></string>
为了验证这个流程,我们可以写一个简单的 Controller:
package com.example.multitenant.controller;
import com.example.multitenant.context.TenantContext;
import com.example.multitenant.service.TenantService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class TenantController {
@Autowired
private TenantService tenantService;
@GetMapping("/data")
public String getData(@RequestHeader(value = "tenant-id", required = false) String tenantId) {
// 设置租户上下文
TenantContext.setTenantId(tenantId);
try {
// 验证租户
tenantService.validateTenant();
return "Data for tenant: " + tenantId;
} finally {
// 清理上下文,防止内存泄漏
TenantContext.clear();
}
}
}
预期结果: - 当请求头包含有效的 `tenant-id`(如 "tenant1")时,返回 "Data for tenant: tenant1"。 - 当请求头包含无效的 `tenant-id`(如 "invalid")或缺失时,返回 JSON:{"error":"TENANT_ERROR","message":"Invalid or missing tenant ID","tenantId":"invalid"},状态码为 400。
基于程序中某个输入、条件或结果的具体问题
在上述代码中,如果 `tenant-id` 请求头缺失,`TenantContext.getTenantId()` 将返回 `null`。此时 `validateTenant` 方法中的条件 `tenantId == null` 为真,会抛出 `TenantException`,其 `tenantId` 字段为 `null`。最终返回的 JSON 中 `tenantId` 键的值将为 `null`。这是符合预期的行为,因为客户端未提供租户标识。如果希望在这种情况下不返回 `tenantId` 字段,可以在 `GlobalExceptionHandler` 中增加判断:如果 `ex.getTenantId()` 为 `null`,则不从 map 中放入该键。但通常保留 `null` 值有助于调试,表明是缺少参数而非参数错误。











