构建环节Python3.5升级至3.7适配distroless镜像相关技术问询

1. 版本升级对现有代码编译环节的影响 #

Python 3.5 到 3.7 属于向后兼容度较高的小版本迭代，多数纯 Python 代码无需修改即可正常编译运行，仅两类场景会产生影响：

• 若代码包含 C 扩展（比如自定义 ctypes 绑定、Cython 编译模块），之前基于 Python 3.5 编译的二进制文件无法在 3.7 环境运行，必须重新基于 3.7 版本的头文件和动态库编译。
• 3.7 已将async、await正式设为关键字，若现有代码用这两个词作为变量/函数名，编译阶段会直接报错。
• 构建 distroless 镜像时建议采用多阶段构建逻辑：第一阶段用python:3.7-slim作为构建镜像，安装编译依赖、拉取代码、安装依赖包后，仅把运行所需的代码和site-packages目录拷贝到gcr.io/distroless/python3基础镜像中即可，避免编译工具残留。

2. 是否需要调整 requirements.txt 中所有依赖包的版本 #

不需要全量调整，仅需处理不兼容 Python 3.7 的包即可：

• 先把现有 requirements.txt 放到 3.7 测试环境执行pip install -r requirements.txt，如果安装无报错、后续功能测试全量通过，就无需调整任何包版本。
• 仅两类包需要调整：一是安装阶段明确提示不支持 Python 3.7 的旧版本包，二是运行时报语法错误、API 调用错误的包，针对性升级这部分包到兼容 3.7 的最低可用版本即可，无需全量升级。
• 安装完成后可以用pip check命令验证依赖兼容性，避免出现版本冲突。

3. 调整依赖包版本对应用运行的影响 #

是否产生影响取决于依赖包的版本跨度：

• 若仅升级小版本（比如从 x.y.1 升到 x.y.3），这类版本通常仅修复 bug、不改动公共 API，基本不会对运行产生负面影响，反而可能解决潜在的安全和稳定性问题。
• 若需要跨大版本升级依赖包（比如从 1.x 升到 2.x），大概率存在 API 变动，需要对照官方变更日志检查代码中调用的相关接口，调整适配后再上线，必要时可以补充单元测试覆盖相关调用逻辑。
• 调整完依赖版本后必须跑完全量功能测试和性能测试，确认没有功能异常、性能下降的问题再上线生产环境。

内容的提问来源于stack exchange，提问作者Alex Anto