peewee框架中Product模型的CharField字段无法存储数据求助

以下是针对该问题的具体排查与解决步骤：

1. 确认数据库表结构与模型定义一致 #

模型修改后如果未同步更新数据库表，会导致字段无法正常存储数据：

• 使用对应数据库的SQL命令查看表结构：
  • MySQL：DESCRIBE product;
  • SQLite：PRAGMA table_info(product);
    检查product_name字段是否存在、数据类型是否为VARCHAR(100)、是否允许为空。
• 如果表结构与模型不符，使用Peewee的迁移工具（playhouse.migrate）更新表结构，确保字段定义完全匹配。

2. 验证数据写入与存储状态 #

• 在创建商品后，立即打印对象的product_name值，确认内存中对象是否正确赋值：

  product1 = models.Product.create(...)
  print(product1.product_name)  # 查看是否输出预期值
  

• 如果内存中有值但数据库无数据，检查数据库事务是否提交：确认BaseModel使用的数据库连接是否开启自动提交，或在数据写入后手动调用db.commit()。
• 直接执行SQL查询验证数据库存储：

  SELECT product_name FROM product WHERE id = {product1.id};
  

3. 修正模型字段定义以符合业务需求 #

业务上商品名称不能为空，应移除default=""并添加非空约束，强制要求创建时必须传入有效值，避免静默错误：

class Product(BaseModel):
    product_name = peewee.CharField(max_length=100, null=False, index=True)  # 移除default，添加null=False
    # 其他字段保持不变

这样如果创建时未传入product_name，Peewee会直接抛出异常，便于快速定位问题。

4. 检查数据展示逻辑是否有误 #

显示结果中product_name为空，可能并非存储失败，而是读取展示时字段名错误：

• 检查展示代码中是否误用了字段名（比如写成product.name而非product.product_name），确保读取的字段与模型定义一致。

5. 排查BaseModel的自定义逻辑 #

如果BaseModel重写了save()、create()或其他核心方法，可能导致字段被过滤：

• 检查BaseModel的代码，确认没有在方法中忽略product_name字段的写入操作。

内容的提问来源于stack exchange，提问作者Olga Galilaiou