Python+Django开发灵活电商系统：单商户与多商户模式实现

1. 项目背景与核心价值

万推宝商城系统（WTBShop）是一个基于Python开发的电商解决方案，它最大的特点在于同时支持单商户和多商户两种运营模式。作为一个开源项目，WTBShop为中小企业和个人开发者提供了一个快速搭建电商平台的工具集。

我在实际电商系统开发中发现，很多项目要么只支持单商户（如个人网店），要么就必须上完整的多商户系统（如淘宝模式），很少有能灵活切换的解决方案。WTBShop的设计正好填补了这个空白 - 开发者可以用同一套代码，根据业务需求随时切换运营模式。

这个系统的核心价值在于：

• 开发效率：Python+Django的技术栈让后端开发变得高效
• 部署灵活：支持从单店到平台的平滑过渡
• 功能完整：包含商品管理、订单处理、支付对接等电商核心模块
• 开源免费：避免了商业系统的授权费用问题

2. 系统架构与技术选型

2.1 整体架构设计

WTBShop采用典型的三层架构：

1. 表现层：基于Django模板引擎+前端框架（如Bootstrap）
2. 业务逻辑层：Django视图处理核心业务
3. 数据访问层：Django ORM+MySQL/PostgreSQL

对于多商户模式，系统通过租户隔离方案实现数据分离。我测试过两种实现方式：

• Schema隔离：每个商户使用独立的数据库schema
• 字段标记：在关键表中增加tenant_id字段

实际使用中，Schema隔离方案在数据安全性上更优，但会增加数据库管理复杂度。对于中小规模应用，字段标记方案已经足够。

2.2 关键技术组件

1. Django框架：提供MVC架构和丰富的内置功能
2. Django REST framework：为未来API扩展做准备
3. Celery：处理异步任务（如订单邮件通知）
4. Redis：缓存和Celery消息代理
5. 支付对接：已集成支付宝和微信支付SDK

提示：在开发环境我推荐使用SQLite快速验证功能，但生产环境务必切换到MySQL/PostgreSQL。

3. 单商户模式实现详解

3.1 基础配置

安装依赖：

bash复制pip install django==3.2 celery==5.2 redis==4.3

创建项目：

bash复制django-admin startproject wtshop
cd wtshop
python manage.py startapp shop

关键配置（settings.py）：

python复制INSTALLED_APPS = [
    ...
    'shop',
    'django.contrib.humanize',  # 金额格式化
]

# 支付配置
WECHAT_PAY = {
    'appid': 'your_appid',
    'mch_id': 'your_mch_id',
    'key': 'your_key'
}

3.2 核心数据模型

商品模型示例（models.py）：

python复制class Product(models.Model):
    name = models.CharField(max_length=100)
    price = models.DecimalField(max_digits=10, decimal_places=2)
    stock = models.PositiveIntegerField(default=0)
    description = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
    
    def __str__(self):
        return self.name

订单模型需要特别注意状态流转：

python复制class Order(models.Model):
    STATUS_CHOICES = [
        ('pending', '待支付'),
        ('paid', '已支付'),
        ('shipped', '已发货'),
        ('completed', '已完成'),
        ('cancelled', '已取消')
    ]
    user = models.ForeignKey(User, on_delete=models.CASCADE)
    total_amount = models.DecimalField(max_digits=10, decimal_places=2)
    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='pending')
    created_at = models.DateTimeField(auto_now_add=True)

3.3 业务逻辑实现

购物车功能实现要点：

python复制def add_to_cart(request):
    if request.method == 'POST':
        product_id = request.POST.get('product_id')
        quantity = int(request.POST.get('quantity', 1))
        
        # 获取或创建购物车
        cart = request.session.get('cart', {})
        cart[product_id] = cart.get(product_id, 0) + quantity
        request.session['cart'] = cart
        
        return JsonResponse({'success': True, 'cart_total': sum(cart.values())})

支付回调处理需要特别注意安全性：

python复制@csrf_exempt
def wechat_pay_callback(request):
    # 验证签名
    if not verify_signature(request):
        return HttpResponse(status=403)
    
    # 处理订单状态
    order_id = request.POST.get('out_trade_no')
    try:
        order = Order.objects.get(id=order_id)
        if order.status == 'pending':
            order.status = 'paid'
            order.save()
            # 触发支付成功事件
            order_paid.send(sender=Order, order=order)
            return HttpResponse(status=200)
    except Order.DoesNotExist:
        pass
    
    return HttpResponse(status=400)

4. 多商户模式扩展方案

4.1 多商户数据隔离

在settings.py中配置多商户中间件：

python复制MIDDLEWARE = [
    ...
    'shop.middleware.TenantMiddleware',
]

租户模型设计：

python复制class Tenant(models.Model):
    name = models.CharField(max_length=100)
    subdomain = models.CharField(max_length=50, unique=True)
    is_active = models.BooleanField(default=True)
    created_at = models.DateTimeField(auto_now_add=True)

所有需要隔离的模型添加租户关联：

python复制class Product(models.Model):
    tenant = models.ForeignKey(Tenant, on_delete=models.CASCADE)
    # 其他字段...

4.2 商户管理后台

创建商户管理员权限组：

python复制def create_tenant_admin_group(sender, **kwargs):
    if kwargs['created']:
        tenant = kwargs['instance']
        group = Group.objects.create(name=f'{tenant.name}_Admin')
        # 分配权限...
        
post_save.connect(create_tenant_admin_group, sender=Tenant)

商户后台视图权限控制：

python复制@login_required
def tenant_dashboard(request):
    if not request.user.groups.filter(name__endswith='Admin').exists():
        raise PermissionDenied
    # 显示商户专属数据...

4.3 平台级功能实现

商户结算功能核心逻辑：

python复制def calculate_settlement(tenant_id, start_date, end_date):
    orders = Order.objects.filter(
        tenant_id=tenant_id,
        status='completed',
        created_at__range=(start_date, end_date)
    )
    
    total = orders.aggregate(Sum('total_amount'))['total_amount__sum'] or 0
    platform_fee = total * Decimal('0.05')  # 5%平台佣金
    return {
        'total_sales': total,
        'platform_fee': platform_fee,
        'settlement_amount': total - platform_fee
    }

5. 部署与性能优化

5.1 生产环境部署

推荐使用Docker部署：

dockerfile复制FROM python:3.9
ENV PYTHONUNBUFFERED 1

RUN mkdir /code
WORKDIR /code

COPY requirements.txt /code/
RUN pip install -r requirements.txt

COPY . /code/

CMD ["gunicorn", "--bind", "0.0.0.0:8000", "wtshop.wsgi"]

Nginx配置要点：

nginx复制server {
    listen 80;
    server_name yourdomain.com;
    
    location / {
        proxy_pass http://localhost:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    
    location /static/ {
        alias /path/to/static/files;
    }
}

5.2 性能优化实践

数据库优化：

python复制# 避免N+1查询
products = Product.objects.select_related('tenant').filter(is_active=True)

# 分页处理
from django.core.paginator import Paginator
paginator = Paginator(products, 20)

缓存策略：

python复制from django.core.cache import cache

def get_hot_products():
    key = 'hot_products'
    products = cache.get(key)
    if not products:
        products = list(Product.objects.filter(is_hot=True)[:10])
        cache.set(key, products, timeout=3600)  # 缓存1小时
    return products

5.3 安全加固措施

关键安全配置：

python复制# settings.py
SECURE_SSL_REDIRECT = True  # 强制HTTPS
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True
SECURE_HSTS_SECONDS = 31536000  # 1年HSTS

# 防止SQL注入
Product.objects.raw('SELECT * FROM shop_product WHERE id = %s', [product_id])

定期审计日志：

python复制import logging
logger = logging.getLogger('security')

def sensitive_operation(request):
    try:
        # 执行敏感操作
        logger.info(f'Sensitive operation by {request.user}', 
                   extra={'request': request})
    except Exception as e:
        logger.error(f'Operation failed: {str(e)}', 
                    exc_info=True,
                    extra={'request': request})

6. 项目扩展与二次开发

6.1 插件机制设计

创建插件基类：

python复制class ShopPlugin:
    def __init__(self, shop):
        self.shop = shop
    
    def ready(self):
        """插件初始化"""
        pass
    
    def get_urls(self):
        """添加URL路由"""
        return []
    
    def get_admin_menu(self):
        """后台菜单扩展"""
        return []

插件加载机制：

python复制def load_plugins():
    plugins = []
    for entry_point in iter_entry_points('wtshop.plugins'):
        try:
            plugin_class = entry_point.load()
            plugins.append(plugin_class(shop=self))
        except Exception as e:
            logger.error(f'Failed to load plugin {entry_point.name}: {str(e)}')
    return plugins

6.2 API扩展开发

使用DRF创建商品API：

python复制from rest_framework import viewsets

class ProductViewSet(viewsets.ModelViewSet):
    queryset = Product.objects.all()
    serializer_class = ProductSerializer
    
    def get_queryset(self):
        queryset = super().get_queryset()
        if hasattr(self.request, 'tenant'):
            queryset = queryset.filter(tenant=self.request.tenant)
        return queryset

API认证方案：

python复制class TenantAuthentication(TokenAuthentication):
    def authenticate(self, request):
        user, token = super().authenticate(request)
        if hasattr(user, 'tenant'):
            request.tenant = user.tenant
        return (user, token)

6.3 移动端适配方案

响应式模板适配：

html复制<div class="product-card">
    <img src="{{ product.image.url }}" 
         class="img-fluid" 
         alt="{{ product.name }}">
    <div class="product-info">
        <h3>{{ product.name }}</h3>
        <p class="price">{{ product.price|floatformat:2 }}</p>
        <button class="btn btn-primary add-to-cart" 
                data-product-id="{{ product.id }}">
            加入购物车
        </button>
    </div>
</div>

小程序API对接要点：

python复制@app.route('/api/miniprogram/login', methods=['POST'])
def miniprogram_login():
    code = request.json.get('code')
    # 调用微信接口获取openid
    wechat_response = requests.get(
        f'https://api.weixin.qq.com/sns/jscode2session?'
        f'appid={APPID}&secret={SECRET}&js_code={code}&grant_type=authorization_code'
    )
    openid = wechat_response.json().get('openid')
    # 创建或获取用户
    user, created = User.objects.get_or_create(
        wechat_openid=openid,
        defaults={'username': f'wx_{openid[:8]}'}
    )
    # 返回自定义token
    token = create_token(user)
    return jsonify({'token': token, 'user_id': user.id})

7. 常见问题与解决方案

7.1 部署问题排查

1. 静态文件404错误：

   • 检查Nginx配置中的static文件路径
   • 确保执行了python manage.py collectstatic
   • 确认STATIC_ROOT设置正确

2. 数据库连接失败：

   • 检查DATABASES配置中的HOST/PORT
   • 测试数据库账号权限
   • 查看Django的DEBUG日志获取详细错误

3. Celery任务不执行：

   • 确认Redis服务正常运行
   • 检查Celery worker是否启动
   • 验证任务是否正确定义并注册

7.2 开发中的典型错误

1. 多商户数据泄露：

   • 确保所有查询都过滤tenant_id
   • 使用中间件自动添加租户过滤
   • 定期进行安全审计

2. 支付金额不一致：

   • 在支付前锁定订单金额
   • 支付回调时验证金额匹配
   • 记录所有金额变更的审计日志

3. 库存超卖问题：

   python复制from django.db import transaction
   
   @transaction.atomic
   def decrease_stock(product_id, quantity):
       product = Product.objects.select_for_update().get(id=product_id)
       if product.stock >= quantity:
           product.stock -= quantity
           product.save()
           return True
       return False
   

7.3 性能问题优化

1. 商品列表加载慢：

   • 添加适当的数据库索引
   • 实现分页加载
   • 使用缓存热门商品

2. 高并发下单问题：

   • 使用队列处理订单创建
   • 实现分布式锁机制
   • 考虑读写分离架构

3. 搜索性能优化：

   • 集成Elasticsearch
   • 实现异步索引更新
   • 添加搜索建议缓存

在实际项目中，我发现最耗时的往往不是核心功能的开发，而是这些边界条件的处理。比如支付回调的幂等性处理、分布式环境下的库存扣减等，这些都需要在项目早期就考虑好解决方案。