Docker部署.NET Core应用调用API返回500 Internal Server Error问题求助

配置优先级冲突排查 #

• 你当前代码同时配置了UseUrls和UseKestrel下的ListenAnyIP规则，Kestrel的Listen系列配置优先级高于UseUrls，如果两边配置的端口/地址不一致，会导致实际监听规则和预期不符。建议先删除UseUrls配置行，避免规则冲突。
• 确认配置文件中Hosting:http:port、Hosting:https:port的取值，和Docker run命令/Compose文件中暴露的端口、端口映射规则完全匹配。
• 进入运行中的容器内部执行ss -tlnp命令，确认Kestrel实际监听的端口和协议，和你调用API时使用的端口、协议一致。

接口调用规则匹配排查 #

• 开发环境若通过IIS/IIS Express托管，会自动处理部分路由大小写、路径转发逻辑，Docker环境直接用Kestrel托管，需确认调用的API路径、HTTP方法（GET/POST等）、参数传递方式（Query参数/Form表单/Json请求体）和接口定义完全一致。
• 检查是否配置了全局路由前缀，或者容器前端是否有Nginx等反向代理做了路径截断，导致API实际路径和调用路径不符。

HTTPS相关问题排查 #

• 你配置了HTTPS监听使用自定义加载的证书，如果调用API的客户端未信任该自签名证书，会主动断开连接导致调用失败。调试阶段可先临时使用HTTP端口调用API，验证是否是证书信任问题导致的调用失败。
• 确认调用API时的协议（HTTP/HTTPS）和对应端口匹配，禁止用HTTP请求HTTPS端口，也不要用HTTPS请求HTTP端口。

跨域配置排查 #

• 如果是前端页面发起API调用，开发环境可能默认开启了宽松的跨域规则，生产环境配置未生效。检查Startup.cs中的CORS配置，是否允许调用端的源地址、请求方法、自定义请求头。

日志排查 #

• 你已接入Serilog，临时开启Debug级别的日志输出，调用API时查看容器的标准输出日志，确认请求是否到达Kestrel服务，是否有路由匹配失败、参数解析失败、业务逻辑报错等具体信息。

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