跨境电商商城系统搭建实录：多语言Java商城+PayPal支付+商家入驻部署笔记

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

最近帮一个做跨境的客户部署了一套多语言Java商城系统，前后端分离架构，前端Vue后端Java，全开源代码。客户主要面向欧美市场卖家居小件，需要PayPal收款和多商家入驻功能。折腾了两天多，把踩过的坑都记下来，给同样想搭这套系统的朋友参考。

这套系统端比较多，买家端、卖家端、代理端、后台管理端、客服端，五个端分开部署。第一眼看着头大，实际跑起来逻辑挺清晰的，各端职责分明。

功能实测：核心模块逐个过

支付对接

系统原生对接PayPal国际支付，这是客户最看重的点。我在沙箱环境跑了完整流程：下单-跳PayPal-回调-订单状态更新，链路是通的。要注意的是回调验签那块，默认配置的证书路径要改成自己服务器的，不然回调验证一直失败，订单卡在待支付状态。这个坑我排查了一个多小时，日志里只报验签异常，最后发现是curl的CA证书没配。

另外系统还带钱包体系，支持充值提现，银行卡提现走后台审核。钱包明细和提现明细都有独立列表，对账方便。这块如果做二开，建议把提现手续费改成可配置项，原版是写死的。

多语言实现

多语言是这套系统的卖点之一。语言包放在前端resources目录下，目前内置英/中/泰等几种，加新语言就是复制一份语言包逐条翻译。我实测加了西班牙语，大概两百多个词条，一天搞定。注意前端语言切换组件要同步改下拉选项，不然切了语言包前端不认。

商家入驻与一键铺货

卖家端支持商家入驻申请，后台审核通过后商家就能上架商品。一键铺货功能对做多平台的卖家挺实用，商品数据批量导入导出，配合采集接口可以快速填充商品库。客户导入了两千多个SKU，批量上架没报错，就是图片转存到本地OSS时并发高会慢，建议队列分批处理。

基础购物流程

购物车、地址管理、个人资料修改这些常规功能都齐全。收货地址支持多地址保存，买家端可以增删改。地址字段针对跨境场景做了适配，邮编和国家是必填项，这点比一般国内商城系统考虑周到。

部署要点：环境与踩坑

服务器配置我用的是4核8G，CentOS系统，JDK1.8+MySQL5.7+Redis+Nginx。这套系统对Redis依赖不轻，购物车和部分缓存都走Redis，不装直接起不来。

几个关键配置

1. 后端配置文件里数据库、Redis、OSS三块信息都要填对，尤其OSS，商品图片全部走对象存储。
2. Nginx要做前后端分离的反向代理，前端dist静态目录一个server块，后端API一个location，跨域在Nginx层解决比在后端代码里配省事。
3. 客服端是独立WS长连接，记得在防火墙放行对应端口，我一开始忘了这个，客服消息一直发不出去。