1、
情形：启动后端
后端：`cd backend && python3 -m venv .venv && pip install -r requirements.txt`
报错：
like@likeMac backend % python3 -m venv .venv
like@likeMac backend % pip install -r requirements.txt
zsh: command not found: pip
Python 3.13 与旧版 Shapely 之间的兼容性问题。
根本原因在于，Python 3.13 彻底移除了已废弃的 pkgutil.ImpImporter 模块。而你 requirements.txt 中锁定的 shapely==1.8.5.post1 版本较旧，其构建脚本（或它依赖的旧版 setuptools）仍然会调用这个已被删除的接口，导致安装失败。
1：依赖安装（✅ 成功）
| 问题 | 解决 |
|---|---|
shapely==1.8.5.post1 在 Python 3.13 下构建失败 |
改成 shapely>=2.0.4 |
zsh: command not found: pip |
用 source .venv/bin/activate 或 .venv/bin/python -m pip |
| 依赖安装 | 全部装好（Flask 2.2.2、shapely 2.1.2、rasterio 1.4.4 等） |
2：项目结构分析（✅ 完成）
-
app.py→create_app()→ 读config.yaml+ 环境变量 -
_build_database_uri()支持 SQLite（DB_BACKEND=sqlite时） -
.flaskenv未创建（模板叫.flaskenv_template）
3：Docker 方案（✅ 成功，unhealthy 是误报）
-
装 Docker 29.7.2，清出 125GB 空间
-
导入镜像
geoview-jiangxi:cpu-20260910-ui（14GB） -
启动容器
jiangxi-cpu（映射 4173/4174/5178） -
前端已返回 HTTP 200，服务实际在跑 ；
unhealthy只是健康检查探针超时
4：本地 venv 跑后端（⏳ 当前）
已修复：
-
✅
distutils缺失 → 装setuptools<81解决 -
✅ 创建
backend/.flaskenv -
✅ 创建
backend/runtime_data/目录
9/11情况：
