麒麟程序部署检查清单：上线前30分钟，逐项自查这4类问题

为什么要有一份清单？

在信创环境下开发机与生产机物理隔离导致验证机会极少，一旦改错成本高昂。很多人因为忘记检查字体、依赖版本或备份文件而导致上线失败。漏项往往比技术难题更致命。

至于第一部分，环境自检

• . Python 版本

  如果你误用python指向 Python！必须用python3

  python3 --version # 期望输出 ~ python --version # 如果输出 .x，记住永远别用它
  

• . 中文字体

  没有中文字体会导致 matplotlib、PIL 画出的中文全是方块。

  ls /usr/share/fonts/truetype/wqy/wqy-microhei.ttc>/dev/null && echo "✅ 字体存在" || echo "❌ 缺少字体，执行: sudo apt-get install fonts-wqy-microhei"
  

• . 关键依赖版本对比

  用 pip freeze 对比开发机和生产机的依赖；主要核对 Streamlit、pandas、numpy 的版本。老实说，

  python3 -c "import streamlit;说起来，print"
  python3 -c "import pandas;print"
  python3 -c "import numpy;print"
  

  Python	Streamlit	Pandas	Status
  x.x.x	x.x.x	x.x.x	✔
  x.x.x	x.x.x	x.x.x	✔
  x.x.x	x.x.x	x.x.x	⚠
  x.x.x ❌ 不建议用于麒麟程序

  建议维护两个 requirements 文件：requirements_dev.txt 和 requirements_kylin.txt。

• 提醒：如果任何一个关键依赖版本不匹配。即使代码能跑，也极易产生运行时错误或安全漏洞。
• ⚠️ 使用者痛点：在一次性迁移时如果没有提前做好版本锁定。你可能会遇到“找不到模块”或“库冲突”的报错，让你连忙回滚再重试。
• ⚠️ 使用者痛点：缺少中文字体会让图表显示乱码。一眼就能看出是环境问题，但你很难在上线后发现这个细节。其实，
• ⚠️ 使用者痛点：若未备份旧文件。一旦出现不可预料的问题，你只能手动重建整个目录，这耗时且风险大。
• ⚠️ 使用者痛点：端口占用是最常见但最容易忽视的问题之一。一旦被占用，你会被迫重新启动并失去业务窗口。
• ⚠️ 使用者痛点：数据库表结构改动后若未正确迁移，会导致数据查询异常或报错；按理说，这一点往往只在正式环境才显现。

说到一键自检脚本，

将以下脚本保存为 pre_deploy_check.sh 。拷贝到生产机后直接跑即可：

#!/bin/bash
# 麒麟程序部署前自检脚本
echo "========== 麒麟部署自检 =========="
echo ""
## . Python 版本
echo " Python 版本"
python3 --version
if python3 -c 'import sys;
exit else 1)';
其实，n
echo "✅ Python3 可用"
else
echo "❌ Python 版本过低"
fi
## . 中文字体
echo " 中文字体"
if;n
echo "✅ 文泉驿微米黑存在"
else
echo "❌ 缺少字体: sudo apt-get install fonts-wqy-microhei"
fi
## . 依赖版本对比
echo " 依赖版本"
python3 -c 'import streamlit;print'
python3 -c 'import pandas;其实，print'
## . Streamlit API 兼容性检查
echo " Streamlit API 兼容性"
grep -rn 'st\.button.*width' --include='*.py' .>/dev/null && \
echo "❌ 发现 st.button width 用法" || \
echo "✅ 无 width 参数"
grep -rn 'use_container_width' --include='*.py' .>/dev/null && \
echo "⚠️ use_container_width 已弃用。改为 width=\"stretch\"" || \
echo '✅ 无弃用用法'
## . Pandas 日期比较检查
echo " 日期比较用法"
grep -rn '\.date' --include='*.py' .>/dev/null && \
echo '⚠️ 发现 .date 调用，请确认已使用 pd.Timestamp 转换' || \
echo '✅ 无裸 .date'
## . 上传配置检查
echo " 上传大小配置"
if && grep -q maxUploadSize ".streamlit/config.toml";其实，n
echo "✅ 上传限制已配置"
else
echo '⚠️ 未配置 maxUploadSize。默认200MB'
fi
## . 端口占用检测
echo " 端口占用"
if ss -tlnp | grep ':8501';n
echo '⚠️ 8501 被占用'
else
echo '✅ 8501 空闲'
fi
## . 数据库表结构检查
echo " 数据库表结构检测"
if;n
echo '- 数据库文件不存在'
else
python 

至于脚本运行提示，

• ✔所有项目均通过即可放心上线！
• ❌若出现 ❌ 或 ⚠️。请先解决对应问题，运行脚本确认无误后再开启服务！

---

💡 小贴士：

• - 一键脚本覆盖了从代码层到硬件层的大部分常见风险；但仍需手动复核关键业务方法。• “试错”成本太高，所以提前准备好备份与回滚方案很关键。• 对于频繁变更的数据表结构，请在生产数据库上执行 PRAGMA table_info;` 检查字段完整性。• 审计日志与监控告警最好统一到同一台服务器，以便快速定位异常。怎么说呢，• 若时间紧迫。可将上述清单打包成 CI/CD Pipeline 中的一步自动化任务，让机器帮你做第一轮筛查。- 最终目标是让**上线前30分钟**内。只剩下业务功能验证，而不是环境纠错。——祝你成功顺利上线，💪🛡︎