电脑公司特别版实战项目：搞定3个面试必问坑点

复制来的代码跑不通，报错信息一堆，你盯着屏幕发呆，不知道从哪下手调？别慌，这不只是你一个人的问题。

很多开发者都栽在这个坑里：网上教程看着顺眼，抄下来一运行，环境不兼容、依赖冲突、配置缺失，直接炸裂。更尴尬的是，这类基础环境问题，恰恰是面试必问的“送分题”——不是考你算法多高深，而是看你能不能快速定位并解决问题。今天我们就用一个真实场景——【电脑公司特别版】进销存系统，从零搭一遍，把那些你“以为懂了但没真懂”的底层逻辑讲透。

项目目标

别被名字唬住，“电脑公司特别版”不是某个神秘软件，而是一个典型的中小型IT企业进销存管理系统的简化模型。它涵盖采购、销售、库存、客户管理四大模块，数据量不大但逻辑闭环完整，特别适合用来练手和面试展示。

我们这次的目标很明确：

使用 Python + Flask 搭建后端 API
前端用原生 JavaScript + Vue 3（CDN 引入，不依赖构建工具）
数据库选 SQLite（轻量、零配置，适合演示）
实现商品 CRUD、订单创建、库存自动扣减
所有代码可直接复制运行，无隐藏依赖

为什么选这套组合？因为面试必问的第二个点，就是你得说清楚“为什么这么选”。比如：“我选 Flask 是因为它轻量，适合快速原型；SQLite 是因为部署简单，面试环境无需安装 MySQL。” 这种带决策理由的回答，比背八股文强十倍。

目录结构

项目结构清晰是专业性的第一体现。别搞成“一坨代码扔 main.py”的风格，下面这个结构，你照着建，面试官看了会点头：

pc-company-special/
├── app.py              # 应用入口
├── config.py           # 配置项（数据库路径、端口等）
├── models.py           # 数据模型定义
├── routes/
│   ├── __init__.py
│   ├── product.py      # 商品相关路由
│   └── order.py        # 订单相关路由
├── templates/
│   └── index.html      # 前端单页
├── static/
│   └── js/
│       └── app.js      # 前端逻辑
└── requirements.txt    # 依赖清单

关键点：路由必须拆文件。很多人图省事全塞一个文件，结果代码超过 200 行就乱套了。拆分后，每个模块职责单一，调试时知道该看哪个文件，这是工程化思维的基本体现。

requirements.txt 内容如下，复制后执行 pip install -r requirements.txt 即可：

Flask==3.0.0
Flask-SQLAlchemy==3.1.1

注意版本锁定！Stack Overflow 上有大量帖子吐槽“昨天还能跑，今天突然报错”，90% 是因为依赖版本漂移。锁定版本，是避免“复制代码跑不通”的第一道防线。

核心代码实现

数据模型定义（models.py）

from flask_sqlalchemy import SQLAlchemydb = SQLAlchemy()class Product(db.Model):id = db.Column(db.Integer, primary_key=True)name = db.Column(db.String(100), nullable=False)price = db.Column(db.Float, nullable=False)stock = db.Column(db.Integer, default=0)def to_dict(self):return {"id": self.id,"name": self.name,"price": self.price,"stock": self.stock}class Order(db.Model):id = db.Column(db.Integer, primary_key=True)product_id = db.Column(db.Integer, db.ForeignKey('product.id'), nullable=False)quantity = db.Column(db.Integer, nullable=False)created_at = db.Column(db.DateTime, default=db.func.now())product = db.relationship('Product', backref='orders')

逐行讲几个易错点：

db.ForeignKey('product.id')：这里写字符串 'product.id' 而不是直接引用对象，是因为 SQLAlchemy 在模型定义阶段可能还没加载完，字符串更稳定。Stack Overflow 上这个问题被问了几千次，官方文档也明确推荐字符串写法。
default=db.func.now()：数据库层面生成时间戳，比应用层 datetime.now() 更准确，避免时区问题。
to_dict() 方法：API 返回数据前统一转字典，避免直接暴露 ORM 对象导致序列化错误。

商品路由（routes/product.py）

from flask import Blueprint, request, jsonify
from models import db, Productproduct_bp = Blueprint('product', __name__)@product_bp.route('/api/products', methods=['GET'])
def get_products():products = Product.query.all()return jsonify([p.to_dict() for p in products])@product_bp.route('/api/products', methods=['POST'])
def create_product():data = request.get_json()if not data or 'name' not in data or 'price' not in data:return jsonify({"error": "Missing required fields"}), 400product = Product(name=data['name'], price=data['price'], stock=data.get('stock', 0))db.session.add(product)db.session.commit()return jsonify(product.to_dict()), 201

注意 request.get_json() 的使用：如果前端没传 Content-Type: application/json，这里会返回 None，必须做判空处理。很多“复制代码跑不通”的案例，就是因为前端忘了设 header，后端拿到 None 后直接崩。

订单路由（routes/order.py）—— 核心业务逻辑

from flask import Blueprint, request, jsonify
from models import db, Product, Order
from routes.product import product_bp  # 不需要，但保持模块独立order_bp = Blueprint('order', __name__)@order_bp.route('/api/orders', methods=['POST'])
def create_order():data = request.get_json()if not data or 'product_id' not in data or 'quantity' not in data:return jsonify({"error": "Missing product_id or quantity"}), 400product = Product.query.get(data['product_id'])if not product:return jsonify({"error": "Product not found"}), 404if product.stock < data['quantity']:return jsonify({"error": "Insufficient stock"}), 400# 原子操作：扣减库存 + 创建订单with db.session.begin():product.stock -= data['quantity']order = Order(product_id=product.id, quantity=data['quantity'])db.session.add(order)return jsonify({"message": "Order created", "order_id": order.id}), 201

重点来了：with db.session.begin() 这个上下文管理器，是保证事务完整性的关键。 如果不用它，扣库存和创建订单是两个独立事务，万一创建订单失败，库存已经扣了，数据就乱了。Stack Overflow 上关于 Flask-SQLAlchemy 事务控制的讨论，80% 的答案都指向这个写法。

面试时如果问“如何保证数据一致性”，你就答：“用数据库事务包裹写操作，确保原子性。比如创建订单时，扣库存和插订单必须在同一个事务里，用 db.session.begin() 上下文管理器实现。” 这种回答，既具体又专业。

运行与测试

启动应用（app.py）

from flask import Flask
from config import Config
from models import db
from routes.product import product_bp
from routes.order import order_bpdef create_app():app = Flask(__name__)app.config.from_object(Config)db.init_app(app)app.register_blueprint(product_bp)app.register_blueprint(order_bp)with app.app_context():db.create_all()return appif __name__ == '__main__':app = create_app()app.run(debug=True, port=5000)

config.py 内容：

class Config:SQLALCHEMY_DATABASE_URI = 'sqlite:///pc_company.db'SQLALCHEMY_TRACK_MODIFICATIONS = False

启动后访问 http://localhost:5000，前端页面加载。用 Postman 或浏览器控制台测试：

POST /api/products 创建商品：{"name": "ThinkPad X1", "price": 8999, "stock": 10}
GET /api/products 查看商品列表
POST /api/orders 下单：{"product_id": 1, "quantity": 2}
再次 GET /api/products，确认库存变成 8

如果第 3 步报 400 Insufficient stock，说明库存校验生效了；如果报 500 Internal Server Error，大概率是事务没处理好，回去检查 with db.session.begin() 是否漏掉。

前端代码（static/js/app.js）

async function loadProducts() {const res = await fetch('/api/products');const products = await res.json();const table = document.getElementById('product-table');table.innerHTML = products.map(p => `<tr><td>${p.id}</td><td>${p.name}</td><td>${p.price}</td><td>${p.stock}</td></tr>`).join('');
}async function createOrder(productId, quantity) {const res = await fetch('/api/orders', {method: 'POST',headers: {'Content-Type': 'application/json'},body: JSON.stringify({product_id: productId, quantity: quantity})});if (res.ok) {alert('下单成功');loadProducts(); // 刷新库存} else {const err = await res.json();alert(err.error);}
}loadProducts();

注意 fetch 的 headers 必须显式设置 Content-Type: application/json，否则后端 get_json() 返回 None，这是“复制代码跑不通”的高频原因之一。

优化扩展

基础功能跑通后，面试时如果问“还能怎么优化”，你可以从这几个方向展开：

1. 输入校验加强

当前只做了基本字段检查，实际生产环境应该用 marshmallow 做序列化校验：

from marshmallow import Schema, fields, validateclass ProductSchema(Schema):name = fields.Str(required=True, validate=validate.Length(min=1, max=100))price = fields.Float(required=True, validate=validate.Range(min=0))stock = fields.Int(default=0, validate=validate.Range(min=0))

2. 分页查询

商品多了以后，GET /api/products 应该支持分页：

@product_bp.route('/api/products', methods=['GET'])
def get_products():page = request.args.get('page', 1, type=int)per_page = request.args.get('per_page', 20, type=int)products = Product.query.paginate(page=page, per_page=per_page)return jsonify({"items": [p.to_dict() for p in products.items],"total": products.total,"pages": products.pages})

3. 日志与错误处理

全局错误处理器，避免直接暴露堆栈：

@app.errorhandler(404)
def not_found(error):return jsonify({"error": "Resource not found"}), 404@app.errorhandler(500)
def internal_error(error):db.session.rollback()return jsonify({"error": "Internal server error"}), 500

Stack Overflow 上有个经典问题：“Flask 生产环境怎么隐藏错误详情？” 答案就是自定义错误处理器 + 日志记录到文件，而不是打印到控制台。