Python Flask+Vue学生宿舍管理系统开发实战-代码聚汇网

Python Flask+Vue学生宿舍管理系统开发实战

网络小妖精·2026-08-24·阅读 23 GEO检测（免费）

Python FlaskVue学生宿舍管理系统

|难度：普通|阅读约 14 分钟

1. 项目概述

这个基于Python Flask后端+Vue前端的学生宿舍管理系统，是我去年为某高校信息化建设项目开发的一套完整解决方案。系统从实际管理需求出发，整合了学生信息管理、宿舍分配、访客登记、报修处理等核心功能模块，采用前后端分离架构，数据库选用MySQL 5.7版本。整套代码经过生产环境验证，日均处理3000+次操作请求，稳定运行超过8个月无重大故障。

提示：本系统特别适合高校信息化部门二次开发，或计算机专业学生作为全栈开发学习项目。源码包含完整的权限控制设计和API文档，各模块采用组件化开发，便于功能扩展。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 技术架构解析

2.1 后端技术栈

Flask框架采用工厂模式组织代码结构，主要依赖包包括：

Flask-SQLAlchemy 2.5.1（ORM处理）
Flask-Migrate 3.1.0（数据库迁移）
Flask-JWT-Extended 4.4.4（身份验证）
Flask-CORS 3.0.10（跨域支持）

数据库设计遵循第三范式，核心表包括：

sql复制CREATE TABLE student (
    id VARCHAR(20) PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    gender ENUM('M','F'),
    class_id VARCHAR(20),
    phone VARCHAR(15)
);

CREATE TABLE dormitory (
    id VARCHAR(10) PRIMARY KEY,
    building VARCHAR(5),
    room_number VARCHAR(4),
    capacity INT,
    current_count INT DEFAULT 0
);

2.2 前端技术栈

Vue 2.6.11 + Element UI 2.15.1构建管理界面，主要技术特征：

采用Vue CLI 4.5.15脚手架初始化项目
axios 0.21.1处理HTTP请求
vue-router 3.5.1实现前端路由
vuex 3.6.2管理全局状态

典型页面组件结构：

code复制src/
├── components/
│   ├── DormAdmin/
│   │   ├── AllocationPanel.vue
│   │   └── StatisticsCard.vue
│   └── Shared/
│       ├── Pagination.vue
│       └── SearchBar.vue
├── views/
│   ├── StudentManagement.vue
│   └── RepairSystem.vue

3. 核心功能实现

3.1 智能宿舍分配算法

系统采用权重评分算法自动分配宿舍，主要考虑因素：

同专业优先（权重40%）
入学年份相同（权重30%）
生源地相近（权重20%）
特殊需求照顾（权重10%）

核心Python实现：

python复制def calculate_match_score(student1, student2):
    score = 0
    if student1.major == student2.major:
        score += 40
    if student1.enrollment_year == student2.enrollment_year:
        score += 30 
    if student1.hometown[:2] == student2.hometown[:2]:
        score += 20
    return score

def auto_allocate():
    unallocated = Student.query.filter_by(dorm_id=None).all()
    available_dorms = Dormitory.query.filter(
        Dormitory.current_count < Dormitory.capacity
    ).all()
    
    for dorm in available_dorms:
        while dorm.current_count < dorm.capacity and unallocated:
            best_match = find_best_match(unallocated, dorm.residents)
            assign_dorm(best_match, dorm)
            unallocated.remove(best_match)

3.2 可视化数据看板

使用ECharts实现的关键指标可视化：

宿舍入住率环形图
报修类型分布饼图
访客登记趋势折线图
学生籍贯分布地图

Vue组件关键配置：

javascript复制methods: {
  initOccupationChart() {
    const chart = echarts.init(this.$refs.chartDom)
    chart.setOption({
      tooltip: { trigger: 'item' },
      series: [{
        type: 'pie',
        radius: ['40%', '70%'],
        data: this.occupationData
      }]
    })
  }
}

4. 系统部署实战

4.1 开发环境搭建

后端环境配置（使用conda）：

bash复制conda create -n dorm python=3.8
conda activate dorm
pip install -r requirements.txt
export FLASK_APP=manage.py
flask db upgrade

前端依赖安装：

bash复制npm install -g @vue/cli
cd frontend
npm install

4.2 生产环境部署

Nginx关键配置示例：

code复制server {
    listen 80;
    server_name dorm.example.com;
    
    location /api {
        include uwsgi_params;
        uwsgi_pass 127.0.0.1:5000;
    }

    location / {
        root /var/www/dorm-frontend/dist;
        try_files $uri $uri/ /index.html;
    }
}

使用Supervisor管理进程：

ini复制[program:dorm-backend]
command=/opt/miniconda3/envs/dorm/bin/uwsgi --ini /var/www/dorm-system/uwsgi.ini
directory=/var/www/dorm-system
user=www-data
autostart=true

5. 常见问题解决方案

5.1 跨域会话保持问题

现象：登录后接口返回401未授权
解决方法：确保前端axios配置携带凭证：

javascript复制axios.defaults.withCredentials = true

同时后端需配置：

python复制CORS(app, resources={r"/*": {"origins": "*"}}, supports_credentials=True)

5.2 数据库连接池耗尽

典型错误日志：

code复制QueuePool limit overflow

解决方案：

增加SQLAlchemy连接池大小

python复制SQLALCHEMY_ENGINE_OPTIONS = {
    'pool_size': 20,
    'max_overflow': 10
}

添加连接回收配置

python复制SQLALCHEMY_ENGINE_OPTIONS = {
    'pool_recycle': 3600,
    'pool_pre_ping': True
}

6. 扩展开发建议

6.1 微信小程序集成

可扩展功能：

学生扫码报修
访客预约登记
宿舍电费查询

接口改造要点：

python复制@app.route('/api/wechat/login', methods=['POST'])
def wechat_login():
    code = request.json.get('code')
    # 调用微信API获取openid
    openid = get_wechat_openid(code)
    user = Student.query.filter_by(wechat_openid=openid).first()
    if user:
        access_token = create_access_token(identity=user.id)
        return jsonify(access_token=access_token)

6.2 智能电表对接

硬件集成方案：

Modbus TCP协议读取电表数据
定时任务更新数据库：

python复制from apscheduler.schedulers.background import BackgroundScheduler

def update_electricity():
    meters = ElectricityMeter.query.all()
    for meter in meters:
        current = read_meter_value(meter.ip)
        record = ElectricityRecord(
            meter_id=meter.id,
            value=current,
            record_time=datetime.now()
        )
        db.session.add(record)
    db.session.commit()

scheduler = BackgroundScheduler()
scheduler.add_job(update_electricity, 'interval', minutes=30)
scheduler.start()

这套系统在实际部署时，我特别建议在数据库层面添加触发器来维护宿舍当前人数统计。例如当学生住宿记录变更时，自动更新dormitory表的current_count字段，这比在应用层维护要可靠得多。具体实现可以参考这个MySQL触发器示例：

sql复制DELIMITER //
CREATE TRIGGER after_student_insert
AFTER INSERT ON student_dorm
FOR EACH ROW
BEGIN
    UPDATE dormitory 
    SET current_count = current_count + 1
    WHERE id = NEW.dorm_id;
END//
DELIMITER ;