Flutter使用DIO调用POST接口时报405及Socket超时错误如何解决

HTTP 405 错误触发原因 #

• 405错误为HTTP方法不允许，最常见原因是请求路径与后端路由规则不匹配：后端路由要求路径末尾携带斜杠时，未加斜杠的请求会被301/302重定向，重定向过程中请求方法会自动转为GET，与后端要求的POST方法不符，触发405。
• 未显式指定请求的Content-Type为application/json，后端无法正确识别JSON格式的请求体，拒绝POST请求。
• 后端接口实际支持的请求方法不是POST，比如要求PUT/GET方法，方法不匹配触发报错。

Socket 超时错误触发原因 #

• 请求域名配置错误：报错日志中显示的目标地址为com.companyName.com，属于格式错误的域名（域名后缀需在末尾，正确格式应为companyName.com），域名解析失败导致连接超时。
• 超时时间配置过短：请求携带imagebase64字段，base64编码会比原文件体积大33%左右，大体积数据传输时，Dio默认的10秒超时时间无法满足传输需求，触发超时。
• 网络波动或服务器侧限流：弱网环境下传输慢，或请求被服务器防火墙/限流规则拦截，也会导致连接超时。

405 错误修复 #

• 修正请求路径，末尾添加斜杠，避免重定向导致的请求方法变更。
• 显式指定请求头Content-Type为application/json，适配后端JSON格式要求。
• 与后端确认接口允许的请求方法，若不是POST则修改为对应方法即可。

超时错误修复 #

• 核对并修正请求域名为正确的业务域名，避免域名解析失败。
• 手动延长Dio的超时时间，适配大文件base64传输场景，参考代码如下：

// 初始化Dio并配置全局超时
final dio = Dio();
dio.options.connectTimeout = const Duration(seconds: 30); // 连接超时30秒
dio.options.receiveTimeout = const Duration(seconds: 30); // 接收超时30秒
dio.options.sendTimeout = const Duration(seconds: 30); // 发送超时30秒

final data = _analyseCard.toJson();
var url = "https://<替换为正确的公司域名>/api/v1/users/analysecard/";
Response response = await dio.post(
    url,
    data: data,
    options: Options(
      responseType: ResponseType.json,
      contentType: Headers.jsonContentType,
    )
);
print('response : $response');
return response;

• 优化上传逻辑：将base64上传改为multipart/form-data格式的文件上传，降低传输体积，减少超时概率。
• 增加重试机制：针对超时类错误添加2-3次自动重试逻辑，规避偶发网络波动导致的请求失败。

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