Odoo文件上传限制深度优化指南：从源码修改到系统级配置
作为企业级ERP系统的核心组件，Odoo的文件上传功能经常成为业务流程中的瓶颈。许多团队在实施过程中发现，默认的25MB限制根本无法满足现代办公场景需求——无论是工程设计图纸、多媒体素材还是批量数据导入，这个阈值都显得捉襟见肘。本文将彻底解决这个痛点，不仅提供各版本源码修改方案，还会揭示更安全的系统级配置方法。
1. 理解Odoo文件上传机制的多层限制
Odoo的文件上传限制实际上是一个复合型约束体系，开发者需要理解其三个关键层级：
- 前端JavaScript验证层：负责用户界面的即时反馈
- Python中间件处理层：处理实际的文件传输逻辑
- Web服务器代理层：Nginx/Apache等服务的独立限制
注意：仅修改前端代码会导致验证绕过但上传失败，必须确保各层级限制同步调整
以Odoo 16为例，完整的限制检查流程如下：
sequenceDiagram 用户->>+前端JS: 选择文件(>25MB) 前端JS-->>-用户: 显示错误提示 用户->>+Python控制器: 绕过JS上传大文件 Python控制器->>+Web服务器: 转发请求 Web服务器-->>-Python控制器: 返回413错误 Python控制器-->>-用户: 传输失败2. 各版本Odoo源码修改全攻略
2.1 Odoo 12-14版本修改方案
对于较老版本，主要修改点集中在静态JS文件中。以Odoo 12为例：
- 定位核心验证文件：
find /odoo12/source -name "basic_fields.js" -exec grep -l "25 * 1024" {} \;- 修改
web/static/src/js/fields/basic_fields.js第1414行：
// 原始代码 file_size: 25 * 1024 * 1024, // 修改为（示例调整为100MB） file_size: 100 * 1024 * 1024,- 清理缓存并重启服务：
sudo service odoo restart sudo rm -rf /var/lib/odoo/.local/share/Odoo/cache/*2.2 Odoo 15-16版本的特殊处理
新版本将上传逻辑迁移到了slides模块中，需要修改不同文件：
| 版本 | 文件路径 | 关键行号 | 搜索关键词 |
|---|---|---|---|
| Odoo15 | website_slides/static/src/js/slides_upload.js | 441 | attachmentUpload |
| Odoo16 | website_slides/static/src/js/slides_upload.js | 561 | MAX_FILE_SIZE |
典型修改示例：
// Odoo15/16通用修改方案 const MAX_FILE_SIZE = 25 * 1024 * 1024; // 修改此处的25为所需值2.3 Odoo 17+的全新架构调整
从Odoo 17开始，上传机制进行了重大重构，需要修改两个关键位置：
- Python HTTP核心配置(
odoo/http.py)：
# 查找以下参数并修改 DEFAULT_MAX_UPLOAD_SIZE = 25 * 1024 * 1024- 前端工具库配置(
web/static/src/core/utils/files.js)：
export const MAX_FILE_SIZE = 25 * 1024 * 1024;重要提示：Odoo 17+需要同时修改前后端配置才能生效
3. 超越源码修改：系统级优化方案
单纯修改源码存在升级兼容性问题，推荐以下更健壮的解决方案：
3.1 使用配置参数覆盖（Odoo 15+）
在配置文件odoo.conf中添加：
[options] web.max_file_upload_size = 268435456 # 256MB优势：
- 无需修改源码
- 升级时自动保留设置
- 支持动态调整
3.2 Web服务器级调整
Nginx配置示例：
client_max_body_size 256M; client_body_buffer_size 128M; proxy_read_timeout 300s;Apache配置示例：
LimitRequestBody 2684354563.3 数据库存储优化
大文件上传还需考虑存储配置：
ALTER SYSTEM SET max_locks_per_transaction = 256; -- 对于PostgreSQL数据库特别重要4. 企业级部署的最佳实践
分级存储策略：
- ≤50MB：直接存数据库
- 50MB-1GB：文件系统存储
- ≥1GB：对象存储集成（AWS S3/阿里云OSS）
健康检查监控：
# 监控上传失败的请求 grep "413 Request Entity Too Large" /var/log/nginx/access.log- 客户端优化技巧：
// 分片上传实现示例 const chunkSize = 10 * 1024 * 1024; // 10MB分片 for (let start = 0; start < file.size; start += chunkSize) { const chunk = file.slice(start, start + chunkSize); await uploadChunk(chunk); }5. 疑难问题排查指南
当修改未生效时，按此流程排查：
确认所有服务已重启
sudo systemctl restart odoo nginx检查浏览器缓存
// 强制刷新缓存 location.reload(true);验证配置加载顺序
[options] ; 确保自定义配置在最后加载检查多组件限制冲突
# 查看当前生效的限制 grep -r "max_file_upload_size" /etc/
对于超大规模文件（>2GB）传输，建议考虑专用文件传输服务集成方案，而非单纯调整上传限制。
