spring boot 全局异常处理可以通过配置 @controlleradvice 捕获 dns 解析异常,但需要明确的是,dns 解析失败通常发生在 http 客户端发起请求时,而非 spring mvc 控制器内部。因此,你需要在调用外部服务的代码层(如使用 resttemplate 或 webclient)中捕获 unknownhostexception 或 dnsnameresolverexception,并将其转换为自定义异常,再由全局异常处理器统一返回 json 响应。

RestTemplate 如何捕获 UnknownHostException
在使用 RestTemplate 发起 HTTP 请求时,如果目标域名无法解析,会抛出 java.net.UnknownHostException。这个异常属于 IOException 的子类,通常不会被 Spring MVC 的默认异常处理器直接捕获为业务异常。为了在全局异常处理中统一处理,建议在 Service 层显式捕获该异常,并抛出自定义的业务异常(如 DnsResolutionException),这样全局异常处理器就能拦截到它。

import org.springframework.web.client.RestTemplate;
import org.springframework.http.ResponseEntity;
import java.net.UnknownHostException;
public class DnsService {
private final RestTemplate restTemplate = new RestTemplate();
public String fetchFromExternal() {
try {
ResponseEntity<String> response = restTemplate.getForEntity("http://non-existent-domain.com/api", String.class);
return response.getBody();
} catch (UnknownHostException e) {
throw new DnsResolutionException("DNS resolution failed for target host", e);
}
}
}
上述代码展示了如何在 Service 层捕获 UnknownHostException 并转换为自定义异常。当调用 fetchFromExternal() 时,如果域名无效,将抛出 DnsResolutionException,随后由全局异常处理器处理。
WebClient 如何处理 DnsNameResolverException
如果使用 WebClient(基于 Reactor 的非阻塞 HTTP 客户端),DNS 解析失败会抛出 io.netty.resolver.dns.DnsNameResolverException。与 RestTemplate 类似,需要在调用处捕获该异常,并转换为自定义异常,以便全局异常处理器能够统一处理。此外,WebClient 的异常处理机制基于 Mono 和 Flux,可以使用 onErrorResume 进行局部处理,但最终仍需通过全局异常处理器返回标准响应。

import org.springframework.web.reactive.function.client.WebClient;
import reactor.core.publisher.Mono;
import io.netty.resolver.dns.DnsNameResolverException;
public class WebClientDnsService {
private final WebClient webClient = WebClient.create();
public Mono<String> fetchFromExternalWebClient() {
return webClient.get()
.uri("http://non-existent-domain.com/api")
.retrieve()
.bodyToMono(String.class)
.onErrorResume(DnsNameResolverException.class, e ->
Mono.error(new DnsResolutionException("DNS resolution failed for target host", e))
);
}
}
上述代码展示了如何使用 WebClient 捕获 DnsNameResolverException 并转换为自定义异常。通过 onErrorResume,可以在响应式流中处理 DNS 解析失败的情况,并最终由全局异常处理器返回统一的 JSON 响应。
全局异常处理器如何统一返回 JSON 响应
全局异常处理器通过 @RestControllerAdvice 注解实现,可以捕获所有控制器中抛出的异常,并返回统一的 JSON 格式响应。对于 DNS 解析异常,我们需要定义一个自定义异常类 DnsResolutionException,并在全局异常处理器中专门处理它。这样,无论使用 RestTemplate 还是 WebClient,DNS 解析失败都会以相同的 JSON 格式返回给客户端。
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.http.ResponseEntity;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(DnsResolutionException.class)
public ResponseEntity<ErrorResponse> handleDnsException(DnsResolutionException ex) {
ErrorResponse error = new ErrorResponse("DNS_RESOLUTION_FAILED", ex.getMessage());
return ResponseEntity.status(HttpStatus.BAD_GATEWAY).body(error);
}
}
import lombok.Data;
@Data
public class ErrorResponse {
private String code;
private String message;
public ErrorResponse(String code, String message) {
this.code = code;
this.message = message;
}
}
上述代码展示了如何定义全局异常处理器 GlobalExceptionHandler,并专门处理 DnsResolutionException。当 DNS 解析失败时,客户端将收到如下 JSON 响应:{"code":"DNS_RESOLUTION_FAILED","message":"DNS resolution failed for target host"}。这种处理方式确保了异常处理的统一性和可维护性。


















