UNIAPP多语言跨境电商商城源码搭建实录：FastAdmin后端+支付对接部署笔记

声明：本文仅供技术学习参考，不构成任何投资建议或运营指导；任何实际部署必须遵守当地法律法规，禁止用于任何违法违规用途。

上个月接了个跨境电商的客户单子，对方想上一套多语言商城系统，要支持H5和App双端。我在源码库里翻了一圈，最后定了这套二开过的商城源码——前端UNIAPP，API端ThinkPHP，后台用的FastAdmin框架。整套架构比较成熟，改动空间也大，适合拿来二次开发。这篇文章就当部署笔记，把过程和一些踩坑点记下来。

一、功能实测：这套系统到底能跑什么

部署完第一件事就是对着功能清单挨个过一遍。这套系统的核心是商城+任务派发模块，结构挺清晰：

1. 前端UNIAPP双端支持

前端UNIAPP脚手架可以直接生成H5和App（安卓/iOS）。我用HBuilderX编译了一套H5丢到Nginx上，App走uni-app的云打包出的apk，两边功能一致，没有明显兼容问题。页面做了多语言切换，默认中英文，语言包文件在locale目录下，加新语言直接加json文件就行。

2. 后台商品与订单管理

后台FastAdmin生成的CRUD页面，商品支持多规格、多图、分类树、库存管理。订单流程完整：下单→支付→发货→确认收货→售后。还有个营销模块，可以做限时折扣和满减活动，客户要的促销玩法基本都覆盖到了。

3. 支付与物流对接

支付走的是标准的微信/支付宝H5支付和App支付通道，回调逻辑在API端的pay控制器里，沙箱环境跑通后切换正式密钥。物流这块对接了快递鸟的物流查询接口，后台配置app key就能在订单详情页显示轨迹。跨境部分预留了PayPal回调的扩展位，后期客户要加国际支付通道直接在payment插件目录里改。

4. 任务派发模块

系统里自带一个任务派发模块，管理员可以在后台发布任务（比如新用户注册礼、分享拉新），前端用户领取完成后积分到账。这块客户特别满意，说拿来拉新裂变很实用。积分商城也能兑换实物或优惠券，闭环是通的。

亮点提示：整套系统前后端分离得很干净，API文档齐全，二开成本比我从零搭低太多了。特别是FastAdmin后台，权限粒度到按钮级，运营人员分组授权很省心。

二、部署要点：环境搭建和踩过的坑

服务器我选的是一台2核4G的CentOS 7，跑起来绰绰有余。环境组合：Nginx 1.20 + PHP 7.4 + MySQL 5.7 + Redis（用来做缓存和队列）。

1. 安装顺序别搞错

先导入数据库SQL文件，然后把API端配置到public目录作为站点根目录。FastAdmin后台默认入口需要配置伪静态，Nginx的rewrite规则官方文档有现成的，直接抄。这里我踩了个坑：ThinkPHP的路由用了PATHINFO，Nginx没配pathinfo_info的话所有接口都404，查了半天日志才发现。

2. 跨域和HTTPS

H5端调API必然跨域，API端的中间件里加了cors配置，允许指定域名。App端无所谓跨域，但苹果上架必须HTTPS，所以域名证书提前在宝塔里申请了Let’s Encrypt，一键续期。

3. 前端打包配置

UNIAPP项目里的manifest.json要改自己的appid和域名，API基础地址建议在common/request.js里统一配置成变量，别散落在各页面里，不然换域名要改死个人。

三、二开体验：好不好改

客户要改的东西不少：首页加了个轮播Banner位、商品详情页加了币种切换、注册加了短信验证码。实操下来感受是这套代码注释算良心的，FastAdmin的插件机制也规范，新加个功能直接按插件目录结构复制改，不动核心文件。币种切换这块我在商品表里加了个价格字段存美元价，前端按汇率实时换算，前后端联调大概两天搞定。