聚水潭新订单未同步的解决步骤为：一、检查开放平台授权有效性；二、核对渠道API配置完整性；三、排查数据库及奇门代理服务连接；四、清空缓存并手动触发同步；五、确认代理系统启用并分析同步日志。
如果您在聚水潭中未看到新订单自动进入系统，或订单列表长时间无更新，则可能是由于同步机制中断、授权失效或配置异常所致。以下是解决此问题的步骤：
一、检查聚水潭平台授权状态
聚水潭依赖开放平台授权获取外部渠道订单数据，若授权过期或被主动撤销，将导致订单完全停止拉取。需确认当前授权是否处于有效期内，且覆盖所需店铺与数据权限范围。
1、登录聚水潭后台，进入「设置 > 基础设置 > 开放平台」。
2、点击「奇门自定义场景授权&配置」，查看各已授权店铺的「授权有效期」和「授权状态」。
3、对显示为已过期或未授权的店铺，重新点击「授权」并完成OAuth流程。
4、确认所选接口类型包含「订单查询」，且勾选了对应商城平台（如淘宝、京东、拼多多等）。
二、验证渠道对接配置完整性
部分电商平台需在聚水潭中单独配置API密钥、店铺ID、同步周期等参数，缺失任一字段均会导致订单无法触发下载动作。
1、进入「渠道管理 > 渠道配置」，选择对应电商平台（例如：抖音小店、快手小店）。
2、核对「AppKey」「AppSecret」「ShopID」三项是否完整填写，且与该平台开发者后台一致。
3、检查「同步开关」是否为开启状态，并确认「同步时间间隔」未设为“不自动同步”。
4、对拼多多、快手等受限平台，需特别确认授权方式是否为「商家自研」或「服务商」模式，并满足九数云文档中注明的数据获取条件。
三、排查数据库及服务连接异常
聚水潭本地服务组件（如奇门代理服务、同步中间件）若与数据库断连，会导致订单缓存堆积但无法写入主表，表现为界面无数据却无报错提示。
1、进入服务器后台，执行命令systemctl status jimen-proxy，确认奇门代理服务运行状态为active (running)。
2、使用mysql -u root -p登录数据库，执行SHOW DATABASES LIKE 'jimen%';，验证核心库是否存在且可访问。
3、检查日志路径/opt/jimen/logs/sync-order.log，搜索关键词Connection refused或timeout。
4、若发现连接失败记录，重启数据库服务：systemctl restart mysqld，再重启奇门代理：systemctl restart jimen-proxy。
四、清空缓存并强制触发一次手动同步
前端缓存或任务队列积压可能掩盖真实同步结果，强制刷新可验证底层链路是否通畅。
1、在聚水潭后台点击右上角头像，选择「系统工具 > 清空缓存」。
2、返回「订单管理 > 订单同步」页面，点击「同步设置」右侧的立即同步按钮。
3、在弹出窗口中选择目标店铺、起始日期（建议设为昨日），点击「开始同步」。
4、同步完成后，查看下方「发单日志」区域，确认提示信息为上传订单数据成功而非“无新订单”或“网络错误”。
五、校验代理系统启用状态与日志输出
当使用代理后台同步订单时，若代理系统本身未启用或日志模块未激活，将导致同步动作静默失败，界面不报错也不更新。
1、进入「系统设置 > 代理管理」，确认「代理系统开关」处于启用状态。
2、点击「日志管理 > 同步日志」，筛选最近1小时内记录，检查是否存在ERROR或WARN级别条目。
3、若日志为空，进入服务器执行tail -f /var/log/jimen/proxy-sync.log，再次点击同步按钮，实时观察输出流。
4、发现类似database connection failed报错时，按第三步方法重装或修复数据库连接。
