413 Request Entity Too Large Sorry for the inconvenience.解决方案-Powered by Tengine tengine采用了tengine-优雅草吴银满|卓伊凡

你遇到的错误信息：

413 Request Entity Too Large
Sorry for the inconvenience.
Please report this message and include the following information to us.
Thank you very much!
URL: https://stqingtingadmin.youyacao.com/prod-api/uploadVideo
Server: vm-8-3-centos
Date: 2025/05/10 13:05:34
Powered by Tengine
tengine

这是一个 HTTP 413 状态码错误，意思是客户端请求体（即上传的数据）超过了服务器允许的最大大小限制，导致服务器拒绝处理请求。

产生原因

• 你上传的视频文件或数据体积超过了服务器配置的最大允许上传大小。
• 服务器使用的是 Tengine（基于 Nginx 的一个高性能 Web 服务器），默认配置可能限制了上传大小。

解决方案

1. 如果你是该服务器的运维或管理员

需要调整 Tengine（类似 Nginx）的配置，增加允许上传文件的大小限制。

具体步骤：

1. 打开服务器上 Tengine 的主配置文件，通常在 /etc/nginx/nginx.conf 或者类似路径。
2. 找到或者添加 client_max_body_size 指令。例如：

http {
    ...
    client_max_body_size 100M;  # 这里设置允许最大上传为100MB，视需要调整
    ...
}

1. 保存配置文件后，重启 Tengine 服务：

sudo systemctl restart tengine
# 或者
sudo service tengine restart

1. 重新尝试上传。

2. 如果你是普通用户，无法修改服务器配置

• 尝试压缩或者分割上传文件，减少单次上传文件大小。
• 联系该网站或服务的技术支持，告知错误信息和上传需求，请求他们调整服务器配置。
• 查看是否有其他上传接口或方式支持更大文件。

3. 其他注意事项

• 有时上传限制不仅由服务器 Web 服务设定，还可能受后端应用（如 API 后台）或防火墙限制。
• 如果你自己开发应用，确认客户端请求大小设置也足够。

总结

错误 413 表示上传文件大小超限，从服务器角度需要增加 client_max_body_size 参数值；从用户角度需要减小上传文件体积，或联系服务器管理员解决。

这里我们如果找不到 tengine 服务器配置，我们尝试以下方法

如果找不到 Tengine/Nginx 的配置文件位置，可以按照以下系统化的方法进行定位：

方法 1：通过进程信息查找配置路径

步骤：

1. 查找 Nginx/Tengine 主进程：

ps aux | grep -E 'nginx|tengine'

• 输出结果中会显示主进程的启动命令，通常包含 -c 参数指定配置文件路径，例如：

root      1234  0.0  0.1  12345  6789 ?        Ss   10:00   0:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf

2. 提取配置文件路径：

• 从输出中直接获取 -c 后面的路径（如 /etc/nginx/nginx.conf）。

方法 2：通过 Nginx/Tengine 测试命令

步骤：

1. 运行以下命令显示配置路径：

nginx -t 2>&1 | grep -i "using configuration"

• 输出示例：

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: using configuration /etc/nginx/nginx.conf

方法 3：搜索默认配置目录

常见默认路径：

# 检查默认配置目录
ls -l /etc/nginx/               # 最常见路径
ls -l /usr/local/nginx/conf/    # 源码编译安装可能在此
ls -l /usr/local/tengine/conf/  # Tengine 专用路径

# 全局搜索
find / -name "nginx.conf" 2>/dev/null
find / -name "tengine.conf" 2>/dev/null

方法 4：检查包含client_max_body_size的配置

步骤：

1. 若已找到主配置文件（如 /etc/nginx/nginx.conf），检查其中是否包含：

http {
    client_max_body_size 10M;  # 默认值通常较小（如1M）
}

2. 如果主配置中未设置，可能在以下位置：

• 虚拟主机配置（如 /etc/nginx/conf.d/*.conf）
• 站点单独配置（如 /etc/nginx/sites-enabled/default）

方法 5：通过日志定位配置

步骤：

1. 查看错误日志，通常日志会记录加载的配置文件：

grep "loading configuration" /var/log/nginx/error.log

2. 日志路径可能在：

/var/log/nginx/error.log
/usr/local/nginx/logs/error.log

方法 6：确认 Tengine 安装路径

步骤：

1. 如果使用 Tengine，运行以下命令获取安装信息：

tengine -V

• 输出会显示编译参数和默认前缀路径（如 --prefix=/usr/local/tengine），配置文件通常在此路径下的 conf/ 目录。

修改配置后的操作

1. 找到配置文件后，在 http 或 server 块中添加：

client_max_body_size 100M;  # 按需调整大小

2. 测试配置并重启：

nginx -t   # 测试配置语法
systemctl restart nginx  # 重启服务

特殊情况处理

• Docker 环境：需进入容器内修改配置：

docker exec -it <容器名> /bin/bash

• Kubernetes：需通过 ConfigMap 或挂载卷修改配置。

通过以上方法，一定能定位到配置文件位置。如果仍无法找到，可能是非标准安装或自定义路径，

然后 以上方案对我们其实不管用的，我们的tengine 是没有在服务器上搭建的 我们主要用的是腾讯云的cdn 因此这个服务在cdn

如果您的服务使用的是 腾讯云 CDN，并且错误提示显示服务器是 Tengine，那么实际上 Tengine 是腾讯云 CDN 的边缘节点服务器，而不是您自己的服务器。因此，您无法直接修改 Tengine 的 client_max_body_size 配置，因为这是腾讯云 CDN 的内部设置。

为什么会出现 413 Request Entity Too Large？

腾讯云 CDN 默认对上传文件大小有限制，通常：

• 默认 POST 请求体大小限制：一般为 32MB（不同 CDN 产品可能不同）。
• 如果您的上传请求（如 uploadVideo）超过这个限制，就会返回 413 错误。

解决方案（针对腾讯云 CDN）

由于您无法直接修改 Tengine 配置，您可以采取以下方法解决：

方法 1：调整腾讯云 CDN 的上传文件大小限制

腾讯云 CDN 默认限制上传大小，但某些产品（如 COS 回源 + CDN）可能支持调整：

1. 登录 腾讯云 CDN 控制台。
2. 找到对应的 域名配置，进入 高级配置 或 缓存配置。
3. 查找 “POST 请求大小限制” 或 “上传文件大小限制”（不同 CDN 版本可能位置不同）。
4. 如果没有直接选项，可以尝试：

• 提交工单 联系腾讯云客服，申请调整 CDN 节点的 client_max_body_size（部分企业级客户可调整）。
• 如果使用的是 腾讯云 COS + CDN，可以在 COS 控制台 调整上传限制。

方法 2：改用分片上传（推荐）

如果无法调整 CDN 限制，可以采用 分片上传（Chunked Upload） 方式：

1. 前端 将大文件切割成多个小片段（如 10MB/片）。
2. 逐个上传，避免单次请求超过 CDN 限制。
3. 后端 接收所有分片后合并成完整文件。

示例（前端 JS 分片上传）：

async function uploadLargeFile(file) {
  const CHUNK_SIZE = 10 * 1024 * 1024; // 10MB
  let chunks = Math.ceil(file.size / CHUNK_SIZE);

  for (let i = 0; i < chunks; i++) {
    const chunk = file.slice(i * CHUNK_SIZE, (i + 1) * CHUNK_SIZE);
    const formData = new FormData();
    formData.append("file", chunk);
    formData.append("chunkIndex", i);
    formData.append("totalChunks", chunks);

    await fetch("https://your-api.com/uploadChunk", {
      method: "POST",
      body: formData,
    });
  }
}

并没有在腾讯云后台找到相关配置 ，

方法 3：绕过 CDN 直接上传到源站

如果 CDN 限制无法调整，可以：

1. 让客户端直接上传到源站（不经过 CDN）：

• 例如，使用 https://your-origin-server.com/uploadVideo 而非 CDN 域名。
• 在源站（如 Nginx）调整 client_max_body_size：

server {
    client_max_body_size 500M;  # 允许大文件上传
}

2. 仅静态资源走 CDN，上传 API 直连源站：

• 例如：

• CDN 域名：https://cdn.yourdomain.com（用于 JS/CSS/图片）
• 上传 API 直连：https://api.yourdomain.com/uploadVideo（不经过 CDN）

方法 4：使用腾讯云 COS 直传（最佳方案）

如果您的业务涉及大文件上传（如视频），建议 直接使用腾讯云 COS（对象存储）：

1. 前端 使用 COS SDK 直传文件到 COS。
2. 后端 只需返回临时密钥（STS），无需处理文件流。
3. CDN 仅用于加速访问，不上传。

优势：

• 文件不经过您的服务器，减轻负载。
• COS 支持 分片上传、断点续传，适合大文件。
• 可结合 CDN 加速下载。

总结

推荐方案：

1. 如果是小文件（<50MB） → 联系腾讯云调整 CDN 限制。
2. 如果是大文件（视频等） → 使用 分片上传 或 COS 直传。

如果仍有问题，建议 提交腾讯云工单

我卓伊凡 在使用中未发现问题，但是我同事发现了 于是我们继续找找原因

Tags：nginx 上传文件大小限制