Odoo 12新主题阿拉伯语站点全站灰显问题求解

前端层优先排查 #

• 校验RTL样式加载状态：Odoo阿拉伯语默认启用RTL（从右到左）布局，先打开浏览器元素审查，确认html根标签的dir属性值为rtl，再检查网络请求列表里主题的RTL专属CSS文件是否正常加载，有没有出现404、加载截断的情况。
• 定位灰显相关CSS规则：选中body或最外层页面容器，查看计算样式中的opacity、filter、visibility、display属性，排查是否被意外设置了opacity: 0、filter: grayscale(100%)、visibility: hidden这类规则，确认规则来源是否为RTL专属样式或线上缓存的旧样式。
• 验证静态资源合并冲突：线上Odoo默认开启CSS/JS合并压缩，本地测试如果未开启该配置，可能出现RTL样式合并后优先级冲突的问题。可以临时在后台设置-通用设置-开发者工具中关闭「CSS/JS资源合并」选项，刷新阿拉伯语站点验证是否恢复，若恢复则需要调整RTL样式的选择器权重，避免合并后被其他样式覆盖。

后端配置层排查 #

• 检查多语言视图继承规则：如果主题针对阿拉伯语做了单独的QWeb视图继承，进入开发者模式的视图列表，搜索主题相关的阿拉伯语专属视图，确认视图优先级、继承顺序是否正常，有没有被其他第三方模块的视图覆盖，是否存在异常报错标记。
• 核对主题文件权限：线上服务器主题的静态资源文件如果权限不匹配，可能出现RTL样式文件可读权限不足的问题，检查主题文件夹权限是否和Odoo运行用户匹配，一般设置为odoo:odoo、权限值755即可。
• 对比线上本地环境差异：确认线上和本地的Odoo 12补丁版本是否一致，有没有额外安装RTL布局增强、多语言优化类的第三方模块，可临时禁用非必要模块排查冲突。

特殊场景排查 #

• 检查阿拉伯语站点专属配置：如果给阿拉伯语站点单独设置了维护模式、访问权限限制、灰度发布规则，先确认规则是否误触发，可以用超级管理员账号登录后访问阿拉伯语前端验证是否正常展示。
• 查看Odoo运行日志：QWeb渲染如果遇到RTL专属语法错误，可能出现渲染中断但浏览器控制台无JS报错的情况，开启Odoo debug日志模式，访问阿拉伯语站点时查看日志输出，排查是否存在QWeb渲染相关的报错信息。

内容的提问来源于stack exchange，提问作者Courageous Heart