Docker部署NextJS13与.NET Core7开发环境POST请求异常排查

核心原因：客户端组件请求无法解析Docker服务名 #

NextJS 13中，服务器组件在容器内部运行，能通过Docker服务名server-app访问后端；但客户端组件在浏览器中执行，浏览器属于宿主机网络，无法识别Docker内部的服务名server-app，导致DNS解析失败（ERR_NAME_NOT_RESOLVED）。你提到GET接口能正常访问，大概率该请求是在服务器组件中发起的，而POST请求是在客户端组件中触发的。

解决方案 #

方案1：配置NextJS反向代理（推荐） #

在NextJS项目根目录创建next.config.js，添加代理规则，将前端请求转发到后端容器：

/** @type {import('next').NextConfig} */
const nextConfig = {
  async rewrites() {
    return [
      {
        source: '/api/:path*',
        destination: 'http://server-app/api/:path*', // 容器内访问后端的地址
      },
    ];
  },
};

module.exports = nextConfig;

前端代码中请求接口时，直接使用相对路径：

// 替换原来的 http://server-app/api/item
fetch('/api/item', { method: 'POST', /* 其他请求配置 */ })

这种方式的优势：

• 服务器组件请求直接走容器内的server-app地址
• 客户端组件请求先发送到NextJS开发服务器，再由服务器转发到后端容器，避免浏览器直接解析Docker服务名

方案2：宿主机映射端口访问 #

如果不想配置代理，前端请求可以使用宿主机的映射端口（服务端docker-compose中映射的8050）：

fetch('http://localhost:8050/api/item', { method: 'POST', /* 其他请求配置 */ })

注意事项：

• 需要在.NET Core后端配置CORS，允许http://localhost:3000访问，避免跨域报错
• 生产环境部署时需要调整地址，灵活性不如代理方案

方案3：统一Docker网络配置（验证网络连通性） #

虽然你说明所有容器在同一网络，但检查服务端docker-compose的网络配置：服务端默认使用development_network，而客户端使用外部网络server_development_network。需要确保服务端容器确实加入目标网络：
修改服务端docker-compose.dev.yml的网络配置：

networks:
  server_development_network:
    external: true

services:
  server-app:
    # 保留原有其他配置
    networks:
      - server_development_network
  database:
    # 保留原有其他配置
    networks:
      - server_development_network

重新启动服务端容器：

docker-compose -f docker-compose.dev.yml down
docker-compose -f docker-compose.dev.yml up -d

验证容器网络连通性：
进入客户端容器，尝试ping服务端容器：

docker exec -it client-container ping server-app

如果能ping通，说明网络无问题，回到前两个方案解决客户端请求的DNS解析问题。

额外检查点 #

• 确认.NET Core后端的POST接口/api/item路由配置正确，无拼写错误
• 查看后端容器日志，确认POST请求是否到达后端：

docker logs server-container

• 若使用方案2，检查后端CORS配置是否允许http://localhost:3000 Origin访问

内容的提问来源于stack exchange，提问作者Bert Van Hecke