Micronaut HttpClient对非标准HTTP状态码的处理优化

在Micronaut框架的HttpClient实现中，我们发现了一个关于非标准HTTP状态码处理的潜在问题。当服务端返回非标准HTTP状态码（如551）时，框架的异常处理机制存在一些需要改进的地方。

问题背景

在标准的HTTP协议中，定义了一系列标准状态码（如200、404、500等）。然而在实际应用中，服务端可能会返回一些非标准状态码。按照HTTP协议规范，客户端应当能够处理这些非标准状态码，至少应当能够正确获取状态码数值和响应体内容。

原始实现的问题

Micronaut HttpClient在处理响应时，会尝试将状态码转换为HttpStatus枚举。当遇到非标准状态码时，这个转换会抛出IllegalArgumentException。这导致两个主要问题：

1. 原始响应信息（包括状态码和响应体）在异常处理过程中丢失
2. 客户端无法获取到服务端返回的实际错误信息

技术细节分析

问题的核心在于HttpClientIntroductionAdvice类中的两处关键代码：

1. 在判断是否为404错误时，直接调用了getStatus()方法
2. 在异常处理流程中，同样依赖了HttpStatus枚举的转换

这种实现方式违反了HTTP协议的灵活性原则，因为HTTP协议本身允许自定义状态码，客户端应当能够处理这些非标准响应。

解决方案

改进后的实现应该：

1. 直接比较状态码的数值而非依赖枚举转换
2. 保留完整的响应信息，包括非标准状态码和响应体
3. 确保异常处理链不会丢失原始错误信息

具体修改包括将类似HttpStatus.NOT_FOUND == ex.getStatus()的判断改为HttpStatus.NOT_FOUND.getCode() == ex.getResponse().code()，这样就能正确处理非标准状态码的情况。

对开发者的影响

这一改进对开发者意味着：

1. 现在可以正确处理服务端返回的任何状态码
2. 错误处理逻辑能够获取完整的错误信息
3. 与各种API的兼容性更好，特别是那些使用自定义状态码的API

最佳实践建议

基于这一改进，我们建议开发者在处理HTTP响应时：

1. 不要假设服务端只会返回标准状态码
2. 在错误处理中同时考虑状态码数值和响应体内容
3. 对于非标准状态码，可以将其视为5xx系列错误进行通用处理

这一改进已在Micronaut 4.7.x版本中得到修复，建议开发者升级到最新版本以获得更好的兼容性。