最近公司内部系统需要升级，我负责在 FastApiAdmin 基础上开发一个会议纪要管理模块。本来以为就是个普通的增删改查功能，一两天就能搞定。结果前后折腾了将近一周，把后端开发中能遇到的坑几乎踩了个遍。这篇文章把我的真实经历记录下来，不讲空话，只说实际问题和对策。一、项目背景我们团队需要一个会议纪要管理功能，具体要求如下：支持会议基本信息的录入和维护纪要内容需要支持图文混排的富文本格式可以上传会议录音、PPT等附件不同部门的人员只能看到自己部门的会议记录支持按会议主题、时间、参会人等条件搜索选型时用了 FastApiAdmin，主要看中它基于 FastAPI 的高性能和自带的后台管理界面。二、遇到的主要问题及处理方式问题一：参会人员搜索慢得无法忍受一开始图省事，我把参会人员直接存成了 JSON 格式。数据量到几百条时还好，超过一千条后，按参会人搜索接口响应需要好几秒。后来把参会人员单独拆成一张关联表，每一条参会记录都关联会议编号。同时在人员姓名字段上加上了数据库索引。改造之后，同样据量下的搜索响应时间降到了毫秒级。问题二：富文本内容提交总是报错前端用的是市面上常见的富文本编辑器，提交的内容里会带有各种 HTML 标签和特殊符号。FastApiAdmin 默认有数据格式校验，遇到这些内容就直接拒绝了，会议纪要根本存不进去。排查后发现是校验规则把富文本内容当成了普通文本在检查。调整方案是把纪要内容字段的校验规则放宽，允许接收任意文本格式，问题就解决了。问题三：上传录音文件经常超时会议录音文件动不动就几十兆，用常规的上传方式，前端等不了那么久就会断开连接。FastApiAdmin 自带的上传示例都是处理小文件的，没有针对大文件的方案。我换成了异步处理的模式：前端先把会议的基本信息保存好，拿到会议编号后再单独上传附件。上传接口接收到文件后立刻返回一个凭证，真正的文件存储和后续处理放到后台慢慢执行，用户不需要干等着。问题四：权限控制只做了一半配置好权限之后发现，虽然接口已经拦截了无权限的访问，但菜单上那些没权限的模块还是显示出来的。用户点进去才发现报错，体验很不好。后来改成了后端动态生成菜单的方式。用户登录成功后，系统根据他的角色权限，只把有权限访问的菜单项返回给前端。这样界面上看不到的就不能点，权限控制才算完整。三、模块的整体规划这次开发我把代码分成了几个清晰的层级：数据层：定义会议纪要相关的数据库表结构结构层：定义前端和后端之间的数据交互格式接口层：提供增删改查、搜索、分页等功能的访问入口业务层：放置导出PDF、发送会议提醒等稍微复杂的逻辑界面层：存放自定义的前端页面模板这样分层的好处是，后来产品经理提了好几次需求变更，每次只需要改对应的层级就行，不会牵一发动全身。四、给同样在做二次开发的朋友几点建议关于数据查询：尽量使用框架自带的分页和过滤组件，自己从头写反而容易出问题，而且风格也不统一。关于操作留痕：会议纪要比较敏感，谁在什么时间改了什么内容最好都有记录。可以用框架的日志功能，每次修改自动记录操作人和操作时间。关于无用数据清理：有的人新建了会议纪要点几下就放弃了，留下一堆草稿数据。可以设置定时任务，比如每天凌晨清理七天以上未完成的草稿记录。关于数据库变更：多人协作开发时，数据库结构的变更特别容易冲突。强烈建议用版本管理工具来管理数据库迁移，每个人改了模型之后生成迁移文件，提交到代码仓库统一执行。五、写在最后这次给 FastApiAdmin 加会议纪要模块的经历让我明白了一个道理：看似简单的功能，真正做起来总会遇到各种意料之外的问题。框架本身提供了很多便利，但二次开发时还是要吃透它的设计思路。如果你也在做类似的开发工作，记住几点：遇到问题先翻翻框架源码里的示例，很多答案就在里面善用 FastAPI 本身的依赖注入，比自己去写中间件要省事得多权限控制要做到界面和接口双重保障，单拦一边是不够的文件上传这种耗时操作一定要异步化，否则用户端体验会很差希望这篇记录能帮到正在踩坑或者即将踩坑的你。欢迎在评论区交流你的开发经验。
https://www.4ssf.com/76cq/480.html
https://www.4ssf.com/76cq/481.html
https://www.4ssf.com/76cq/482.html
https://7sfchuanqi.cn/kfb/86.html
https://7sofu.cn/fg/92.html
https://www.7sfuu.cn/lb/151.html
https://www.sosouc.com/kfxx/389.html
https://www.88dj.cn/yxgl/338.html
https://www.175lt.com/xxgl/338.html
https://www.17173cq.com/yx/1194.html
https://www.945wf.com/xkcq/339.html
https://www.857game.com.cn/fgcq/68.html
https://www.14game.com.cn/lb/135.html
https://www.02game.com.cn/lbzx/69.html
https://www.45game.com.cn/kfb/147.html
https://www.06game.com.cn/cqgl/355.html
https://www.31game.com.cn/kf/148.html
https://www.26game.com.cn/yxzx/82.html
https://www.30game.com.cn/mfcz/144.html