爬坑说明

商城配置过程中，有很多的细节，文档已经尽量把所有细节给列出来，但是还是无法避免会遗漏，或者看文档时候疏忽没注意，这里再把所有容易忽略的细节罗列一下

关于命令执行

所有命令请都务必在项目根目录下执行，否则命令执行没报错也是无效的，如果是宝塔，查看网站可以找到根目录形如 /www/wwwroot/项目目录

公众号相关

公众号配置

• 打开 公众平台->设置与开发->公众号设置->功能设置 业务域名:填写前端h5域名，JS接口安全域名:填写前端域名，网页授权域名：填写后台接口域名
• 打开 公众平台->开发 基本配置->公众号开发->IP 白名单，将服务器 ip 地址配置一下
• 如果要使用商城自带的微信管理，设置自定义菜单，粉丝，或者自动回复等功能，请配置并启用 公众平台->开发 基本配置->公众号开发->服务器配置，服务器地址以及token 请在商城配置->平台配置->公众号配置 处查看；如果不使用商城微信管理等功能，请忽略

小程序相关

服务器域名配置

在开发工具模式下，不校验域名合法性是自动开启的，但是到了体验版或者正式版会出现小程序打开直接显示网络错误，这时候请检查服务器域名是否配置了

• 登录小程序平台，开发->开发管理->开发设置，找到服务器域名，将域名填入，具体配置方式请看这里有详细说明 服务器域名配置

支付相关

订单不存在问题

• 因为系统默认订单十五分钟不支付自动关闭订单，使用的是延迟队列功能，这里订单立马就被关闭是因为 application/extra/queue.php 配置文件队列驱动没有修改，请按照队列文档进行配置队列配置

安装 微信支付宝整合插件 【v2 版本支付】

• 为了兼容插件市场的 微信支付宝整合插件，shopro 商城隐藏了自己的 yansongda 包，所以这个包目前必须要安装
• fastadmin 后台插件管理，找到微信支付宝整合插件，然后直接安装，不需要在这里进行配置，只需要在商城配置->支付配置里面配置微信支付参数即可

公众号微信支付

• 首先在商城配置->支付配置配置微信支付参数，再配置 商城配置->平台配置，配置微信公众号参数
• 请在微信商户平台配置微信支付授权目录，history 模式：域名 + /pages/order/payment/， hash模式： 域名 + /#/pages/order/payment/

h5 微信支付（也就是微信浏览器之外的普通浏览器支付）

• 商户号必须申请微信h5支付
• 商城配置->平台配置->h5,请配置绑定了同一个商户号的 公众号的或者小程序的 appid 和 secret
• 必须要在手机上测试，并且手机上必须要有微信客户端才行，因为 微信 h5 支付是通过浏览器调起的微信客户端进行付款

跨域相关

• 默认前端接口都是使用fastadmin 自带跨域的，只需要在 application/config.php 配置好要跨域的域名，但是这个跨域只能解决接口跨域，并不能解决前端h5生成海报时候的图片跨域问题，需要在nginx 中单独配置图片的跨域
• 如果是 apache，或者想看更详细的跨域文档， 请点击这里跨域配置
• 如果使用了对象存储，并且前端部署的有 h5, 请在对象存储中配置跨域，否则h5端海报将无法生成

海报生成相关

如果使用fastadmin 自带的用户测试生成海报，请一定要给这个用户重新上传一下头像，否则无法生成海报

h5 生成海报

h5 端海报无法生成， 一般都是跨域问题所致，可以按照如下方式解决一下

• 如果未配置对象存储，请配置服务器的图片跨域
• 如果是配置了对象存储，请在对象存储，bucket 处配置跨域，允许前端域名跨域

小程序端生成海报

• 小程序必须至少发布一版才可正常生成小程序码
• 检查小程序服务器域名 downloadFile 域名配置，涉及到的所有图片地址都需要配置，如果使用了对象存储包括对象存储的域名也必须要配置

客服相关

• 如果shopro版本大于等于 1.3.0 建议使用反向代理方式配置，配置简单，也不需要放行端口
• 如果不是反向代理方式，请将客服端口放行，宝塔上放行防火墙端口，并且放行服务器安全组(云服务器)或者防火墙端口
• 配置好之后，一定要在调试模式下运行，错误会直接输出在命令行，这样就可以解决 90% 以上的问题，否则可能卡几个小时都解决不了

上传图片&店铺装修保存失败

如果前端无法上传图片，或者是店铺装修保存一直卡着不动，并且安装了对象存储插件

• 检查对象存储配置是否正确
• 请打开对象存储配置，并且将如下配置，勾选为如下图所示

小程序端定位报错

如果定位无法使用，并且 console【控制台】有如下警告

getLocation:fail the api need to be declared in the requiredPrivateInfos field in app.json

打开小程序后台，如下图位置，申请开通这三个权限

如果前端代码 < 1.3.9，请在 manifest.json 源码视图 找到 mp-weixin 模块下添加如下代码

"requiredPrivateInfos" : [ "getLocation", "chooseLocation", "chooseAddress" ]

添加完如下图