Windows运行Odoo14报错：无法执行sassc命令样式编译失败

故障表现 #

Windows系统完成Odoo14安装后，启动本地localhost服务时触发样式编译失败，核心报错信息如下：

The style compilation failed, see the error below. Your recent actions may be the cause, please try reverting the changes you made.
    
Could not execute command 'sassc'
This error occured while compiling the bundle 'web.assets_common' containing:
    - /web/static/lib/bootstrap/scss/_functions.scss
    - /web/static/lib/bootstrap/scss/_mixins.scss
    - /web/static/src/scss/bs_mixins_overrides.scss
    - /web/static/src/scss/utils.scss
    - /web/static/src/scss/primary_variables.scss
    - /web_editor/static/src/scss/web_editor.variables.scss
    - /web_editor/static/src/scss/secondary_variables.scss
    - /web/static/src/scss/secondary_variables.scss
    - /web/static/lib/bootstrap/scss/_variables.scss
    - /web/static/lib/tempusdominus/tempusdominus.scss
    - /web/static/src/scss/fonts.scss
    - /web/static/src/scss/ui.scss
    - /web/static/src/scss/ui_extra.scss
    - /web/static/src/scss/navbar.scss
    - /web/static/src/scss/mimetypes.scss
    - /web/static/src/scss/modal.scss
    - /web/static/src/scss/animation.scss
    - /web/static/src/scss/rainbow.scss
    - /web/static/src/scss/datepicker.scss
    - /web/static/src/scss/daterangepicker.scss
    - /web/static/src/scss/banner.scss
    - /web/static/src/scss/colorpicker.scss
    - /web/static/src/scss/popover.scss
    - /web/static/src/scss/translation_dialog.scss
    - /web/static/src/scss/keyboard.scss
    - /web/static/src/scss/name_and_signature.scss
    - /web/static/src/scss/web.zoomodoo.scss
    - /web/static/src/scss/color_picker.scss
    - /web/static/src/scss/fontawesome_overridden.scss
    - /web_tour/static/src/scss/tip.scss
    - /web_tour/static/src/scss/keyframes.scss

该错误触发于web.assets_common静态资源包编译阶段，仅安装npm相关sass包无法解决问题。

排查修复步骤 #

• 先确认sassc命令全局可用：Odoo识别的是系统可直接调用的原生sassc可执行文件，不是npm仓库里的JS版sassc封装包。下载对应Windows 64位版本的sassc预编译程序，将其所在目录添加到系统PATH环境变量，配置完成后新开命令行窗口执行sassc -v，能正常返回版本号才说明配置生效。注意sassc程序不要存放在带中文、空格或特殊字符的路径下，避免Windows路径解析失败。
• 补全Python侧依赖：激活Odoo运行对应的Python环境（如果使用虚拟环境需要先进入虚拟环境），执行pip install libsass安装sass的Python绑定，安装完成后进入Python交互环境执行import sass，无报错说明依赖安装正常。
• 清理旧缓存：sassc配置完成后，先删除Odoo生成的旧静态资源缓存，缓存路径一般在Odoo数据目录下的filestore/对应数据库名/assets文件夹，将整个assets文件夹删除即可，同时清空浏览器本地缓存，避免加载旧的错误资源。
• 校验运行环境版本兼容性：如果是源码方式部署的Odoo14，不要使用14.x以上版本的Node.js，Odoo14仅适配12.x-14.x版本的Node，切换到对应版本Node后，在Odoo源码根目录执行npm install安装全量前端依赖。
• 排除自定义模块干扰：如果近期新增过第三方模块、修改过系统自带的SCSS文件，先临时禁用新增的自定义模块，排除SCSS语法错误触发的编译异常，再验证sassc编译流程是否正常。

操作完成后重启Odoo服务即可正常加载编译样式资源。

内容的提问来源于stack exchange，提问作者Faeze Shakori