CDKTF无法识别PyPI安装的第三方包问题求助

问题重现 #

执行cdktf diff时触发报错，核心错误为：

ModuleNotFoundError: No module named 'boto3'

虽然boto3已添加到Pipfile的[packages]区域，且虚拟环境中已安装，但CDKTF仍无法访问该依赖。

错误日志 #

$ cdktf diff

⠏  Synthesizing
[2022-11-11T14:03:01.343] [ERROR] default - Traceback (most recent call last):
  File "/Users/jcbcodes/workspace/project/main.py", line 25, in <module>
    from utils.foo import bar
  File "/Users/jcbcodes/workspace/project/utils/foo.py", line 5, in <module>
    import boto3
ERROR: cdktf encountered an error while synthesizing

Synth command: pipenv run python main.py
Error:         non-zero exit code 1

Command output on stderr:

    Traceback (most recent call last):
      File "/Users/jcbcodes/workspace/project/main.py", line 25, in <module>
        from utils.foo import bar
      File "/Users/jcbcodes/workspace/project/utils/foo.py", line 5, in <module>
        import boto3
    ModuleNotFoundError: No module named 'boto3'

Pipfile内容 #

[[source]]
name = "pypi"
url = "https://pypi.org/simple"
verify_ssl = true

[requires]
python_version = "3"

[packages]
cdktf = "~=0.13.3"
pytest = "*"
boto3 = "1.26.6"

解决步骤 #

• 重置Pipenv虚拟环境

  1. 删除现有虚拟环境：pipenv --rm
  2. 重新创建并安装所有依赖：pipenv install
  3. 激活虚拟环境：pipenv shell
  4. 验证boto3安装：执行pip show boto3，确认输出包含正确版本信息

• 确保CDKTF使用正确的Python解释器

  1. 获取虚拟环境的Python绝对路径：pipenv run which python
  2. 修改项目根目录下的cdktf.json，将synth命令替换为该绝对路径执行main.py，例如：

     {
       "language": "python",
       "app": "/Users/jcbcodes/.local/share/virtualenvs/project-xxxx/bin/python main.py"
     }
     

• 排查模块导入问题

  1. 在utils目录下创建空的__init__.py文件，让Python识别该目录为合法模块
  2. 手动验证脚本运行：执行pipenv run python main.py，如果这步也报错，优先解决依赖或导入问题，再重新运行cdktf diff

• 升级工具版本

  1. 升级Pipenv和CDKTF：pip install --upgrade pipenv cdktf
  2. 重新安装依赖：pipenv install

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