150 lines
4.2 KiB
Markdown
150 lines
4.2 KiB
Markdown
# PROJ 数据库配置指南
|
||
|
||
## 问题背景
|
||
|
||
InSAR 管理系统使用地理空间库（GDAL、pyproj）进行坐标转换和空间查询。这些库依赖 PROJ 数据库来执行坐标系转换。
|
||
|
||
**版本冲突问题**：
|
||
- PostgreSQL PostGIS 扩展自带 PROJ 数据库 **v2**（旧版本）
|
||
- GDAL/pyproj 期望 PROJ 数据库 **v3+**（新版本）
|
||
- 版本不匹配会导致警告，甚至**坐标转换错误**
|
||
|
||
## 配置方式
|
||
|
||
### 方式 1：自动配置（推荐）
|
||
|
||
**不需要任何配置**，系统会自动使用 pyproj 的 PROJ 数据库。
|
||
|
||
启动后端时，会看到：
|
||
```
|
||
[*] Configuring PROJ database...
|
||
[*] Auto-detected PROJ_LIB: C:\Users\Administrator\.conda\envs\InSAR\lib\site-packages\pyproj\proj_dir\share\proj
|
||
[*] PROJ version: 9.2.0
|
||
```
|
||
|
||
### 方式 2：手动配置（高级）
|
||
|
||
如果需要使用自定义的 PROJ 数据库，可以在 `.env` 文件中配置：
|
||
|
||
```bash
|
||
# PROJ 数据库路径
|
||
PROJ_LIB=C:\path\to\your\proj\data
|
||
```
|
||
|
||
**配置优先级**：
|
||
1. `.env` 中的 `PROJ_LIB`（如果设置）
|
||
2. pyproj 自动检测（默认）
|
||
|
||
## 验证配置
|
||
|
||
### 方法 1：查看启动日志
|
||
|
||
启动后端时，检查日志输出：
|
||
|
||
```bash
|
||
# 正确配置（使用 pyproj）
|
||
[*] Auto-detected PROJ_LIB: ...pyproj\proj_dir\share\proj
|
||
[*] PROJ version: 9.2.0
|
||
|
||
# 错误配置（使用 PostgreSQL）
|
||
[*] Using PROJ_LIB from .env: C:\Program Files\PostgreSQL\17\share\contrib\postgis-3.6\proj
|
||
```
|
||
|
||
### 方法 2：运行诊断脚本
|
||
|
||
```bash
|
||
# 激活 InSAR 环境
|
||
conda activate InSAR
|
||
|
||
# 运行诊断
|
||
python scripts/check_proj.py
|
||
```
|
||
|
||
诊断脚本会检查：
|
||
- 环境变量 `PROJ_LIB` 的值
|
||
- PROJ 数据库文件是否存在
|
||
- PROJ 版本信息
|
||
- 坐标转换功能是否正常
|
||
|
||
### 方法 3：测试坐标转换
|
||
|
||
```python
|
||
import pyproj
|
||
|
||
# WGS84 to Web Mercator
|
||
transformer = pyproj.Transformer.from_crs("EPSG:4326", "EPSG:3857", always_xy=True)
|
||
x, y = transformer.transform(116.4, 39.9) # 北京坐标
|
||
print(f"WGS84 (116.4, 39.9) -> Web Mercator ({x:.2f}, {y:.2f})")
|
||
# 预期输出: WGS84 (116.4, 39.9) -> Web Mercator (12957588.73, 4851421.18)
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
### Q1: 为什么不能使用 PostgreSQL 的 PROJ 数据库？
|
||
|
||
**A**: PostgreSQL PostGIS 自带的 PROJ 数据库是 v2 版本，而 GDAL/pyproj 期望 v3+ 版本。使用旧版本可能导致：
|
||
- 坐标转换精度下降
|
||
- 某些坐标系不支持
|
||
- 空间查询结果错误
|
||
|
||
### Q2: 如何知道当前使用的是哪个 PROJ 数据库？
|
||
|
||
**A**: 查看后端启动日志，或运行 `python scripts/check_proj.py`。
|
||
|
||
### Q3: 删除数据库重建后，PROJ 警告又出现了怎么办？
|
||
|
||
**A**: 这是正常的。删除数据库后，PostGIS 扩展会重新安装，系统环境变量可能被重置。重启后端即可自动修复。
|
||
|
||
### Q4: 我想使用自定义的 PROJ 数据库，如何配置？
|
||
|
||
**A**: 在 `.env` 文件中设置 `PROJ_LIB` 环境变量：
|
||
|
||
```bash
|
||
PROJ_LIB=D:\custom\proj\data
|
||
```
|
||
|
||
确保该目录包含 `proj.db` 文件。
|
||
|
||
### Q5: 如何确认 PROJ 配置生效？
|
||
|
||
**A**: 执行雷达数据扫描操作，检查日志中是否还有 PROJ 警告：
|
||
|
||
```
|
||
GDAL signalled an error: err_no=1, msg='PROJ: proj_identify: ... DATABASE.LAYOUT.VERSION.MINOR = 2 ...'
|
||
```
|
||
|
||
如果没有此警告，说明配置生效。
|
||
|
||
## 影响范围
|
||
|
||
正确配置 PROJ 数据库对以下功能至关重要：
|
||
|
||
- ✅ **雷达数据扫描**：解析影像坐标系
|
||
- ✅ **空间查询**：隐患点与影像范围匹配
|
||
- ✅ **D-InSAR 处理**：地理配准和坐标转换
|
||
- ✅ **水体监测**：地理编码
|
||
- ✅ **地图显示**：坐标系转换（WGS84 ↔ Web Mercator）
|
||
|
||
## 技术细节
|
||
|
||
### PROJ 数据库版本对比
|
||
|
||
| 来源 | 版本 | 路径 | 推荐 |
|
||
|------|------|------|------|
|
||
| PostgreSQL PostGIS | v2 | `C:\Program Files\PostgreSQL\17\share\contrib\postgis-3.6\proj` | ❌ |
|
||
| pyproj (conda) | v9.2 | `C:\Users\...\envs\InSAR\lib\site-packages\pyproj\proj_dir\share\proj` | ✅ |
|
||
|
||
### 环境变量优先级
|
||
|
||
1. 程序内设置的 `os.environ["PROJ_LIB"]`（最高优先级）
|
||
2. 系统环境变量 `PROJ_LIB`
|
||
3. pyproj 默认路径
|
||
|
||
我们的配置策略是在程序启动时**强制覆盖**环境变量，确保使用正确的 PROJ 数据库。
|
||
|
||
## 参考资料
|
||
|
||
- [PROJ 官方文档](https://proj.org/)
|
||
- [pyproj 文档](https://pyproj4.github.io/pyproj/)
|
||
- [PostGIS 文档](https://postgis.net/)
|