后端服务连接失败怎么办
遇到云店AI后端连接失败、127.0.0.1拒绝连接、5174页面打不开或8765任务服务异常时，按本文检查软件页面、任务服务、端口和启动状态。
当云店AI提示“无法连接本地后端”，或者页面显示 127.0.0.1 拒绝连接时，通常不是淘宝、抖店或互联网断网，而是电脑里的云店AI本地服务没有启动，或者启动后被关闭了。
这篇说明帮助你分清页面服务和任务服务，并按顺序恢复软件。
先判断是哪一种情况
情况一：整个页面打不开
浏览器打开 http://127.0.0.1:5174/ 后显示“无法访问此网站”或“拒绝连接”。
这通常表示云店AI页面服务没有启动。
情况二：页面能打开，但功能无法使用
页面可以正常显示，但出现下面任一种提示：
- 无法连接本地后端
http://127.0.0.1:8765。 - 云店Agent暂时无法读取任务、文件或工具状态。
- 点击开始任务后没有进入任务中心。
这通常表示负责执行任务的本地服务没有启动，或者已经退出。
127.0.0.1 是什么
127.0.0.1 表示“当前这台电脑”，不是外部网站。
127.0.0.1:5174：当前本地测试版的软件页面。127.0.0.1:8765：负责执行任务、读取设置和保存结果的本地服务。
可以把页面理解为操作台，把本地服务理解为真正干活的发动机。操作台能打开，不代表发动机一定已经启动。
当前本地测试版的恢复方法
第一步：启动任务服务
打开云店AI当前项目目录，双击：
应用代码\第一组代码骨架\启动_后端8765_SQLite用户系统.cmd看到启动窗口后先不要关闭。关闭这个窗口会停止本地任务服务。
如果窗口提示 8765 已被占用，通常说明旧服务仍在运行。先测试服务是否正常，不要重复启动多个后端。
第二步：检查任务服务是否正常
在浏览器打开：
http://127.0.0.1:8765/api/health能看到健康状态内容，说明任务服务已经启动。浏览器仍然提示拒绝连接，说明服务没有成功启动，请查看启动窗口中的错误提示。
第三步：页面打不开时再启动页面服务
双击：
应用代码\第一组代码骨架\启动_前端5174_稳定版.cmd页面服务窗口也需要保持运行。然后重新打开或刷新：
http://127.0.0.1:5174/推荐顺序始终是：先启动任务服务，再启动页面服务，最后刷新页面。
桌面软件版本怎么处理
正式桌面软件不需要用户手动寻找前端和后端脚本。遇到连接失败时，先退出云店AI，再从桌面或开始菜单重新打开。
如果软件缩在系统托盘中，请先打开托盘里的云店AI，不要连续启动多个实例。软件已有任务正在运行时，应先进入任务中心查看状态，不要直接结束进程。
为什么会突然断开
常见原因包括：
- 启动窗口被关闭，本地服务随之停止。
- 电脑重启、睡眠、断电或系统更新后，原来的本地服务已经结束。
- 软件被杀毒软件、系统权限或安全策略拦截。
- 同一个端口已经被旧服务占用，新服务没有成功启动。
- 本地服务启动时遇到依赖、配置或文件权限问题并自动退出。
- 用户只打开了页面，没有同时启动负责执行任务的本地服务。
页面能开，云店Agent仍提示无法连接怎么办
请按下面顺序处理：
- 打开
http://127.0.0.1:8765/api/health。 - 如果打不开，重新启动任务服务。
- 如果能打开，回到云店AI页面按
Ctrl+F5强制刷新。 - 仍未恢复时，退出旧页面后重新打开软件。
- 查看任务中心是否有正在运行或等待处理的任务。
云店Agent本身也需要通过本地服务读取工具和任务。后端完全断开时，Agent无法替代本地服务启动任务。
任务运行中连接断开怎么办
先不要反复点击“开始任务”，也不要立刻删除日志或结果文件。
- 打开任务中心查看任务是否仍在运行。
- 浏览器自动化窗口仍在工作时，不要同时启动同一个店铺、同一个登录环境的第二个任务。
- 如果任务已经失败，保留失败原因和详细日志，再按页面建议重试。
- 如果必须停止任务，优先使用任务中心里的停止入口。
强制关闭软件可能中断浏览器操作、表格写入或文件生成。关闭前应先正常停止仍在执行的任务。
不要这样处理
- 不要连续启动多个后端服务。
- 不要在连接失败时反复提交同一个任务。
- 不要随意删除配置、任务记录或运行日志。
- 不要把本地连接失败误认为平台账号失效。
- 不要在表格或文件仍在写入时强制结束软件。
联系客服时准备这些信息
如果按照上面的步骤仍未恢复，请准备：
- 云店AI页面上的完整错误提示。
- 任务服务启动窗口的截图。
http://127.0.0.1:8765/api/health的打开结果。- 页面打不开，还是页面能开但功能不可用。
- 电脑是否刚刚重启、睡眠、断电或更新。
- 断开前是否有任务正在运行。
- 任务中心里的失败摘要；需要进一步分析时再导出详细日志。
这些信息可以帮助客服快速判断是页面服务、本地任务服务、运行环境，还是具体任务本身的问题。