Docker部署应用用Axios/Fetch请求ArrayBuffer出现连接超时错误

针对Docker中使用Axios/Fetch请求返回ArrayBuffer的API出现ERR_SOCKET_CONNECTION_TIMEOUT的问题，结合你提供的配置，给出以下排查和解决方法：

1. 验证host网络模式的兼容性 #

虽然你配置了network_mode: "host"，但Windows/macOS的Docker Desktop对host模式支持存在限制，可能导致容器网络异常。可以尝试切换为端口映射模式测试：

version: '3'
services:
  staging: 
    build: ./
    environment:
      - NODE_ENV=${NODE_ENV}
      - SERVER_PORT=${API_CLIENT_PORT}
    ports:
      - ${API_CLIENT_PORT}:${API_CLIENT_PORT}
    # 注释掉host模式
    # network_mode: "host"

同时确认本地${API_CLIENT_PORT}端口未被其他进程占用。

2. 提升容器资源配额 #

处理大体积ArrayBuffer时，容器内存/CPU不足可能导致请求超时。在docker-compose中添加资源限制配置：

version: '3'
services:
  staging: 
    build: ./
    environment:
      - NODE_ENV=${NODE_ENV}
      - SERVER_PORT=${API_CLIENT_PORT}
    network_mode: "host"
    deploy:
      resources:
        limits:
          cpus: '1.0'
          memory: 1G
        reservations:
          cpus: '0.5'
          memory: 512M

也可以直接在Docker Desktop的「设置-资源」中调高容器可用的内存和CPU额度。

3. 修复容器DNS解析问题 #

容器DNS配置错误可能导致无法解析API域名，进而请求超时。在docker-compose中指定公共DNS服务器：

version: '3'
services:
  staging: 
    build: ./
    environment:
      - NODE_ENV=${NODE_ENV}
      - SERVER_PORT=${API_CLIENT_PORT}
    network_mode: "host"
    dns:
      - 8.8.8.8
      - 1.1.1.1

进入容器内部执行ping <API域名>，验证域名解析和网络连通性是否正常。

4. 调试请求全流程 #

在Axios中添加日志拦截器，追踪请求/响应细节：

const axios = require('axios').default;

// 请求日志
axios.interceptors.request.use(request => {
  console.log(`[REQUEST] ${request.method} ${request.url}`);
  return request;
});

// 响应日志
axios.interceptors.response.use(response => {
  console.log(`[RESPONSE] ${response.status} ${response.config.url}`);
  return response;
}, error => {
  console.error(`[ERROR] ${error.message}`, error.config);
  return Promise.reject(error);
});

// 原请求代码
try {
  const result = await axios({
      method: method,
      url: endpoint,
      headers: {
          'Content-Type': 'text/xml'
      },
      responseType: apiType !== '' ? 'arraybuffer' : 'text'
  });
  return result.data;
} catch (error) {
  console.error('Request failed:', error);
  return false;
}

也可以在容器内用curl模拟请求，排查是否是代码层面的问题：

docker exec -it <容器ID> curl -v -H "Content-Type: text/xml" <API端点> --output test.bin

5. 调整网络传输参数 #

如果API返回的ArrayBuffer体积较大，容器网络的MTU或缓冲区限制可能导致超时。添加sysctl参数调整：

version: '3'
services:
  staging: 
    build: ./
    environment:
      - NODE_ENV=${NODE_ENV}
      - SERVER_PORT=${API_CLIENT_PORT}
    network_mode: "host"
    sysctls:
      - net.ipv4.tcp_mtu_probing=1
      - net.core.rmem_max=16777216

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