Odoo17自定义库存报表t-foreach循环致页面重复问题求助

核心问题定位 #

该问题本质是循环结构被错误嵌套在分页触发容器内，或循环项的样式强制触发了分页，导致每条记录单独生成一页。

具体修复步骤 #

1. 检查并调整报表XML结构
   打开Odoo Studio的报表编辑器，确认t-foreach的嵌套层级：

   • 错误示例（每条记录触发新页面）：

     <page>
       <t t-foreach="docs" t-as="doc">
         <!-- 产品记录内容 -->
       </t>
     </page>
     

   • 正确结构（所有记录在同一页面容器内）：

     <page>
       <table class="table table-bordered">
         <thead>
           <tr>
             <th>产品名称</th>
             <th>库存数量</th>
             <!-- 其他表头字段 -->
           </tr>
         </thead>
         <tbody>
           <t t-foreach="docs" t-as="doc">
             <tr>
               <td><t t-esc="doc.name"/></td>
               <td><t t-esc="doc.qty_available"/></td>
               <!-- 其他字段内容 -->
             </tr>
           </t>
         </tbody>
       </table>
     </page>
     

   确保循环逻辑绑定在表格行（<tr>）层级，而非整个页面容器。

2. 移除强制分页的CSS样式
   检查报表样式中是否存在page-break-after: always这类强制分页的规则，找到后删除：

   /* 需要移除的错误样式 */
   .product-record {
     page-break-after: always;
   }
   

3. 使用Odoo标准报表容器
   基于官方报表模板结构重构，优先使用<div class="page">或官方提供的容器类，避免自定义容器引发的分页异常。

4. 验证动态表格的正确用法
   若使用动态表格，需确保t-foreach直接绑定到表格行，示例：

   <table t-if="docs" class="table table-striped">
     <t t-foreach="docs" t-as="line">
       <tr>
         <td><t t-esc="line.product_id.display_name"/></td>
         <td><t t-esc="line.product_qty"/></td>
       </tr>
     </t>
   </table>
   

后续验证 #

保存修改后，执行以下操作确保生效：

• 清空报表缓存：进入「设置->技术->报表->报表模板」，找到对应报表点击「清空QWeb缓存」
• 重新打印报表，确认多条记录是否显示在同一页面

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