.NET Core部署Umbraco后PostAddFile接口久用出现504超时问题

一、优先排查Nginx超时配置 #

Nginx日志明确提示upstream timed out，先从反向代理超时入手：

• 找到Dokku生成的应用Nginx配置文件，路径一般为/home/dokku/[你的应用名称]/nginx.conf
• 检查文件中是否存在proxy_read_timeout、proxy_connect_timeout、proxy_send_timeout参数，默认值通常为60秒，对于媒体上传这类耗时操作可能不足，建议调整为：

  proxy_read_timeout 180s;
  proxy_connect_timeout 60s;
  proxy_send_timeout 180s;
  

• 修改后执行dokku nginx:reload [你的应用名称]使配置生效，观察问题是否复现
• 同时检查HTTP/2相关超时配置（如http2_idle_timeout），若设置过短可能影响长连接处理

二、排查Umbraco与.NET Core应用层问题 #

重启容器暂时恢复，说明应用层可能存在资源耗尽或异常阻塞：

• 查看Umbraco日志：容器内日志路径为/umbraco/Data/Logs，对应宿主机卷挂载目录，重点查找PostAddFile接口处理时的错误日志，比如文件处理异常、数据库连接超时等
• 监控容器资源占用：用docker stats实时查看容器的CPU、内存使用率，若出现内存持续上涨、CPU长期高负载，大概率存在内存泄漏或死循环
• 生成内存转储分析：进入容器安装.NET Core Diagnostics Tools后，执行dotnet-dump collect生成内存快照，排查未释放的对象
• 临时关闭媒体自动处理：Umbraco默认的图片裁剪、压缩功能可能耗时较长，可临时关闭这些配置，测试是否还会出现超时
• 检查数据库状态：Umbraco处理媒体时需写入数据库，查看数据库日志是否存在连接池耗尽、锁等待、超时等异常

三、排查Docker与Dokku的卷及网络问题 #

• 检查卷目录权限：宿主机上/umbraco/Data和/media卷目录的权限，需确保容器运行用户（通常为www-data或dotnet）拥有读写权限，用ls -l对比初始正常状态的权限配置
• 检查磁盘空间：用df -h查看卷所在磁盘的剩余空间，磁盘满会导致文件写入失败，进而阻塞接口响应
• 测试容器网络连通性：从宿主机直接调用容器内接口curl -X POST http://[容器IP]:4000/umbraco/backoffice/umbracoapi/media/PostAddFile，看是否能正常响应，排除Nginx转发的问题
• 检查Dokku进程状态：用dokku ps:list [你的应用名称]查看应用进程，是否存在僵死、无响应的进程

四、复现与验证步骤 #

• 测试不同大小的文件上传，确认是否仅大文件触发超时，缩小问题范围
• 重启容器后持续监控资源与日志，记录从正常到异常的时间点，排查是否存在特定操作（如批量上传、定时任务）触发问题
• 临时替换反向代理（如改用Caddy）测试，验证是否为Nginx本身或配置问题

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