Odoo 15+ CSV 导出下载功能实现教程-Python教程-PHP中文网

本文详解如何在 Odoo 中通过 transient 模型安全、可靠地生成并下载 CSV 文件，重点解决因缺失 binary 字段导致的「field not found」错误，并提供完整可运行的代码示例与关键注意事项。

本文详解如何在 odoo 中通过 transient 模型安全、可靠地生成并下载 csv 文件，重点解决因缺失 `binary` 字段导致的「field not found」错误，并提供完整可运行的代码示例与关键注意事项。

在 Odoo 中实现 CSV 报表导出功能时，许多开发者会遇到类似 [Field 'file' not found] 的报错（如截图所示），其根本原因在于：ir.actions.act_url 路由中引用了不存在的字段 file，而当前 transient 模型并未定义该字段，也未将生成的 CSV 内容写入其中。

要正确实现可下载的 CSV 导出，必须满足三个核心条件：

✅ 定义一个 fields.Binary 字段用于存储编码后的文件内容；
✅ 在导出方法中将 CSV 字符串经 UTF-8 编码 + Base64 编码后写入该字段；
✅ 使用 web.content URL 正确关联模型、记录 ID、字段名与文件名。

以下是修正后的完整实现方案（适配 Odoo 15+，兼容新旧 API）：

✅ 步骤一：更新 transient 模型（添加 binary 字段与逻辑增强）

import io
import csv
import base64
from odoo import models, fields, api
from odoo.exceptions import UserError


class ReportPatientWizard(models.TransientModel):
    _name = "report.patient.wizard"
    _description = "Patient Reports"

    patient_id = fields.Many2one('hospital.patient', string='Patient', readonly=True)
    gender_filter = fields.Selection([
        ('male', 'Male'),
        ('female', 'Female'),
        ('other', 'Other')
    ], string='Gender Filter')

    # ? 关键：新增 binary 字段，用于存储 CSV 文件内容
    file = fields.Binary(string="Download File", readonly=True, attachment=True)
    filename = fields.Char(string="File Name", readonly=True)

    def _prepare_csv_data(self, patients):
        field_names = ['Name', 'Age', 'Gender']
        output = io.StringIO()
        writer = csv.DictWriter(output, fieldnames=field_names)
        writer.writeheader()

        for patient in patients:
            writer.writerow({
                'Name': patient.name or '',
                'Age': str(patient.age) if patient.age else '',
                'Gender': dict(patient._fields['gender'].selection).get(patient.gender, patient.gender),
            })
        return output.getvalue()

    @api.model
    def download_patient_report(self):
        self.ensure_one()  # ? 强制单记录上下文，避免批量调用异常

        # 构建患者查询条件
        domain = []
        if self.gender_filter:
            domain.append(('gender', '=', self.gender_filter))

        patients = self.env['hospital.patient'].search(domain)

        if not patients:
            raise UserError(_('No patients match the selected criteria.'))

        # 生成 CSV 内容并编码为 base64
        csv_content = self._prepare_csv_data(patients)
        self.file = base64.b64encode(csv_content.encode('utf-8'))
        self.filename = f'patient_report_{fields.Date.today().strftime("%Y%m%d")}.csv'

        # ? 返回标准 web.content 下载动作（注意：model、id、field、filename 必须严格对应）
        return {
            'type': 'ir.actions.act_url',
            'url': f'/web/content/?model={self._name}&id={self.id}&field=file&filename={self.filename}&download=true',
            'target': 'self',
        }

    def print_patient_report(self):
        return self.download_patient_report()

✅ 步骤二：确保视图中无需显示 file 字段（保持隐藏）

不应出现在 XML 表单视图中（除非你希望调试显示），因其仅用于后端传输，前端无需渲染。当前 view.xml 已符合要求，无需修改。

⚠️ 注意事项与最佳实践

编码一致性：务必使用 .encode('utf-8') 再 base64.b64encode()，否则中文等非 ASCII 字符将乱码；
文件名安全：避免在 filename 中包含用户可控特殊字符（如 /, \, ..），本例使用日期格式已规避风险；
附件存储：attachment=True 可选，但建议保留，便于 Odoo 自动清理临时附件（transient 模型记录删除时自动清理）；
性能提示：若患者数据量极大（>10k 行），建议改用流式响应（http.Response）或后台任务（@api.background），避免内存溢出；
权限控制：确保当前用户对 hospital.patient 具有 read 权限，否则 search() 将静默返回空集；
Odoo 版本差异：Odoo 17+ 已弃用 @api.multi，统一使用 @api.model 或实例方法（如上），并配合 self.ensure_one()。