Ubuntu 22.04安装Canvas LMS时bundle install卡pg_query问题求助

1. 为何bundle install安装pg_query时会卡住？ #

• 环境差异：bundle install运行在项目专属的依赖环境中，可能使用项目指定的Ruby版本、gemset（如rvm/rbenv管理的环境），编译时的环境变量也和全局gem install不同。比如全局安装时系统自动加载了libpq-dev等依赖库的路径，但Bundle环境下未正确配置，导致编译过程耗时过长甚至终止。
• 资源限制：pg_query的原生扩展构建需要一定的CPU、内存资源，若系统可用资源不足（比如内存被其他进程占用），编译过程会被拖慢甚至卡住。
• 依赖约束冲突：Canvas的Gemfile可能为pg_query指定了额外的编译参数或依赖条件，这些条件在全局安装时未触发，但Bundle会严格按配置执行，导致构建流程异常。
• 缓存或源的问题：Bundle可能使用了不同的gem源，或者缓存的pg_query源码包存在损坏，导致下载、校验或构建环节受阻。

2. 该gem已安装，为何bundle install仍要安装它？ #

• 项目独立环境机制：Bundle的核心作用是维护项目独立的依赖环境，默认会将gem安装到项目专属路径（如vendor/bundle），而非直接复用全局已安装的gem，以此保证所有开发者的环境完全一致，避免全局版本冲突。
• 依赖约束不匹配：你手动安装的pg_query虽然版本是5.1.0，但Canvas的Gemfile或Gemfile.lock可能指定了更严格的约束，比如特定的平台标记（如x86_64-linux）、编译选项或关联依赖版本，全局安装的版本不满足这些约束，因此Bundle会重新构建符合要求的版本。
• lock文件的强制约束：Gemfile.lock会锁定每个gem的精确版本、平台和校验信息，即使全局有相同版本的gem，只要校验值或平台不匹配，Bundle就会重新安装。

内容的提问来源于stack exchange，提问作者John Hon