PROJ项目中的PROJJSON Schema CORS问题解析与解决方案

PROJ作为开源地理空间数据处理库，其PROJJSON格式在多个地理空间数据规范中被广泛引用。近期用户反馈在浏览器端工具中无法加载PROJJSON Schema的问题，经分析发现这是由于URL重定向和CORS(跨域资源共享)配置变更导致的兼容性问题。

问题背景

PROJJSON Schema原本直接托管在固定URL路径下，但随着PROJ文档系统迁移至ReadTheDocs平台后，所有请求都被重定向至包含版本信息的路径。这种变化带来了两个关键影响：

1. 原始URL不再直接提供Schema文件，而是通过302重定向
2. 重定向后的响应头中缺少必要的CORS头信息

技术影响分析

CORS机制是现代浏览器实施的安全策略，要求跨域资源请求必须得到服务器明确授权。当浏览器端工具(如STAC和GeoParquet的实现)尝试加载Schema进行验证时，由于缺少Access-Control-Allow-Origin等CORS头，请求会被浏览器拦截。

更复杂的是，这些规范已经发布正式版本，其中硬编码的Schema URL无法更新，使得问题必须从服务器端解决。

解决方案演进

PROJ维护团队考虑了多种技术方案：

1. 恢复原始URL的CORS支持：最直接的解决方案，但需要ReadTheDocs平台支持
2. 使用GitHub原始文件：虽然可行，但URL不够规范美观
3. 子项目方案：考虑使用ReadTheDocs的子项目功能，但URL结构不符合需求
4. 版本变量替换：通过文档系统变量保持版本同步，但不解决CORS问题

最终通过与ReadTheDocs团队的协作，平台层面解决了重定向URL的CORS头问题，使得原始URL既能保持重定向功能，又能正确返回CORS头信息。

最佳实践建议

对于类似的技术场景，建议：

1. 关键Schema文件应保持长期稳定的URL
2. 避免将Schema与版本化文档系统深度耦合
3. 确保所有资源URL都配置了适当的CORS策略
4. 对已发布的规范，Schema URL应视为不可变的公共API

PROJ团队通过此次事件也优化了文档系统，确保未来Schema文件的稳定性和可访问性，为整个地理空间数据生态提供了更可靠的基础设施支持。