Odoo 18报表水印打印不显示问题求助

1. 检查水印的CSS与HTML配置 #

确保水印样式正确设置，避免被内容遮挡或渲染失效：

• 推荐使用固定定位+底层层级的CSS写法，示例：

.watermark {
    position: fixed;
    top: 50%;
    left: 50%;
    transform: translate(-50%, -50%);
    opacity: 0.1;
    z-index: -1; /* 确保位于报表内容下方 */
    font-size: 80px;
    color: #333;
    pointer-events: none;
    width: 100%;
    text-align: center;
}

• 在报表模板中，将水印元素放在<body>标签内的最外层，确保不会被其他容器的overflow属性隐藏。比如：

<template id="report_invoice_watermark" inherit_id="account.report_invoice">
    <xpath expr="//body" position="inside">
        <div class="watermark">CONFIDENTIAL</div>
    </xpath>
</template>

2. 适配报表渲染引擎 #

Odoo 18默认使用wkhtmltopdf或WeasyPrint，不同引擎对CSS支持有差异：

• wkhtmltopdf：确保使用0.12.6及以上版本，旧版本对position: fixed等属性支持不佳。若使用图片水印，需确保图片路径正确，且wkhtmltopdf能访问到该文件。
• WeasyPrint：若使用背景图水印，需用background-image替代固定定位元素，示例：

body {
    background-image: url('/your_module/static/src/img/watermark.png');
    background-repeat: repeat;
    background-position: center;
    background-opacity: 0.1;
}

注意：静态文件路径需使用Odoo的绝对路径，可通过浏览器直接访问路径验证是否能加载图片。

3. 调整浏览器打印设置 #

部分浏览器默认禁用背景图形打印，导致水印不显示：

• 在打印预览界面（Chrome/Firefox等），找到「更多设置」，勾选「背景图形」选项后再打印。

4. 排查静态文件与权限问题 #

• 确认水印图片的路径正确，且所在模块已安装并加载静态资源。可通过开发者工具的「网络」标签，检查图片是否成功加载。
• 若使用自定义模块的图片，确保模块的__manifest__.py中已正确声明静态文件目录：

'assets': {
    'web.report_assets_common': [
        'your_module/static/src/css/watermark.css',
        'your_module/static/src/img/watermark.png',
    ],
},

5. 检查模板继承是否生效 #

若通过继承现有报表添加水印，需确保继承路径正确，未被其他模板覆盖：

• 启用开发者模式，进入「报表」设置，查看目标报表的模板是否包含你的水印代码。
• 使用浏览器开发者工具查看渲染后的HTML页面，确认水印元素存在且样式未被覆盖。

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