ERPNext 15安装WooCommerce Connector后设置页面无更新显示求助

开发者阿泽

2026-6-26

解决ERPNext 15 WooCommerce Connector设置不显示问题

检查应用安装状态
先确认WooCommerce Connector是否真的安装成功。进入ERPNext的应用管理器（路径：Home > Settings > Apps），搜索WooCommerce Connector，查看状态是否为"已安装"。如果未安装，重新执行安装命令：
```
bench get-app woocommerce_connector https://github.com/libracore/WooCommerceConnector.git
bench install-app woocommerce_connector
bench restart
```
注意：执行命令时要在ERPNext的bench环境下操作。
验证角色权限
当前登录用户可能没有访问WooCommerce设置的权限。进入用户权限管理（路径：Home > Settings > Users and Permissions > Users），编辑当前用户，检查是否拥有WooCommerce Manager或System Manager角色。如果没有，添加对应角色后刷新页面重试。
清除缓存与重新构建
ERPNext的前端缓存可能导致设置页面未更新，执行以下命令清理缓存并重新构建：
```
bench clear-cache
bench build
bench restart
```
操作完成后，强制刷新浏览器（Ctrl+F5）再查看设置页面。
检查应用兼容性
确认libracore的WooCommerce Connector是否支持ERPNext 15版本。部分第三方应用可能未及时适配新版本，可查看应用的仓库文档或更新记录，确认版本兼容性。如果存在版本不兼容，可尝试使用ERPNext官方集成或等待应用更新。
检查页面路由与自定义设置
部分自定义配置可能修改了菜单路径。进入自定义菜单（路径：Home > Settings > Customization > Menu Manager），搜索"WooCommerce Settings"，确认其是否存在且路径正确。如果菜单未添加，手动创建对应菜单条目，关联到WooCommerce Settings doctype。
查看日志排查错误
如果以上步骤都无效，查看ERPNext的日志文件定位问题：
```
bench logs
```
重点关注与WooCommerce Connector相关的错误信息，比如依赖缺失、数据库表未创建等，根据日志提示进一步修复。