核心作用: 当商城需要更换访问域名时,通过本工具一键批量替换数据库中所有图片、文件等资源的旧域名为新域名,避免因域名变更导致资源无法加载。同时配合服务器配置、微信小程序域名白名单更新等步骤,确保迁移过程平滑无中断。
一句话描述:
配合新域名解析、服务器绑定、SSL证书配置及微信小程序域名白名单更新后,使用本工具批量替换数据库中的旧域名为新域名,完成商城整体域名迁移。
本指南帮助您在更换商城域名时,通过系统工具批量替换资源路径,并完成所有相关配置,确保商城正常运行。
操作前请务必做好数据库备份!
域名迁移完整操作流程(共5步)
第一步:域名解析与授权更换
1、解析新域名:登录您的域名管理后台,将新域名(如 www.newdomain.com)通过 A记录 解析到商城服务器的 IP 地址。
2、联系授权:联系您的服务商(如壹佰网络),将您账号绑定的授权域名更换为新域名。
目的:使新域名能够正确指向服务器,并确保软件授权正常。
第二步:服务器配置(保持新旧域名同时可访问)
重要:在迁移期间,请保持原域名正常访问,以免微信小程序等业务中断。
1、登录您的服务器管理面板(如宝塔)或通过 SSH 登录。
2、创建新站点:绑定新域名,并将站点根目录指向原站点的目录(与原站点相同的文件夹)。
3、配置 SSL 证书:为新域名申请并配置 SSL 证书(HTTPS),确保安全访问。
4、验证:使用新域名在浏览器中访问,应能正常打开与原域名相同的页面(可能存在混合内容警告,暂不处理)。
第三步:微信小程序公众平台配置

1、登录 微信公众平台(小程序管理员扫码)https://mp.weixin.qq.com/。
2、进入【开发】→【开发管理】→【开发设置】。
3、在“服务器域名”区域:
添加新域名:将新域名添加到 request、uploadFile、downloadFile 等对应的白名单中。
暂时保留原域名:不要删除原域名,确保迁移期间小程序仍能正常访问旧资源。
(如果原域名已确定无法访问,则可直接替换为新域名)
4、保存设置。
第四步:后台执行域名迁移

1、使用新域名登录壹佰云管理平台超管账号。
2、进入【门店V3管理后台】→【应用中心】→【域名迁移】页面。
3、在输入框中:
原站点域名:填写原来的域名(例如 http://old.yourdomain.com 或 https://old.com),注意带协议、不带结尾斜杠。
新站点域名:填写新的域名(例如 https://www.newdomain.com)。
4、点击 【确定】,系统将批量替换数据库中所有图片、文件等资源的旧域名为新域名。
5、执行完成后,刷新商城前台,检查图片、样式是否正常显示。

第五步:小程序上传与发布

1、进入【渠道】→【微信小程序】→【工具发布】页面。
2、点击 【上传代码】,将最新配置(包含新域名)提交到微信公众平台。
3、登录微信公众平台,进入【版本管理】,找到刚上传的版本,提交审核。
4、审核通过后,点击 【全网发布】。
5、域名迁移完成。此时可以删除原域名的解析和服务器绑定(可选)。

小贴士
为什么需要保持原域名同时可访问?
因为微信小程序端可能仍有用户在使用旧版本(未及时更新),且域名迁移过程中,数据库替换需要时间。保持双域名并行可避免资源加载失败。
域名格式必须精确:新旧域名必须包含协议(http:// 或 https://),且结尾不要带斜杠 /。
备份数据库:在执行域名迁移前,强烈建议备份数据库,以防意外。
SSL证书:强烈建议新域名使用 HTTPS,否则小程序可能无法正常请求。
测试验证:迁移完成后,使用新域名访问商城所有页面(商品详情、购物车、个人中心等),并测试下单流程,确保一切正常。
常见问题:
Q:执行域名迁移后,图片仍然显示旧域名?
A:可能是浏览器缓存,请清除缓存或使用无痕模式重新访问。如果问题依旧,检查数据库是否全部替换成功,可尝试重新执行迁移。
Q:小程序审核需要多久?
A:通常 1-7 天,请预留时间。迁移过程中原域名不要删除,以免审核期间用户无法使用。
Q:能否只替换部分资源路径?
A:本工具为全局替换,不支持部分替换。如有特殊需求,请联系技术支持。