Google Cloud Run模拟器运行Flask REST API遇flask_smorest导入错误

问题场景 #

使用flask_smorest开发Flask REST API，在Google Cloud Shell编辑器中开发，运行Google Cloud Run模拟器时，收到pylint报错：

##########Linting Output - pylint##########
************* Module app
3,0,error,import-error:Unable to import 'flask_smorest'

我的Dockerfile内容 #

FROM python:3.10

ENV PYTHONUNBUFFERED True

ENV APP_HOME /app 
WORKDIR $APP_HOME
COPY . ./

RUN pip install Flask gunicorn flask-smorest marshmallow

CMD exec gunicorn --bind :$PORT --workers 1 --threads 8 --timeout 0 app:app

我的app.py内容 #

import os
from flask import Flask, request
from flask_smorest import Api


app = Flask(__name__)

app.config["PROPAGATE_EXCEPTIONS"] = True
app.config["API_TITLE"] = "Stores REST API"
app.config["API_VERSION"] = "v1"
app.config["OPENAPI_VERSION"] = "3.0.3"
app.config["OPENAPI_URL_PREFIX"] = "/"
app.config["OPENAPI_SWAGGER_UI_PATH"] = "/swagger-ui"
app.config["OPENAPI_SWAGGER_UI_URL"] ="https://cdn.jsdelivr.net/npm/swagger-ui-dist/"


if __name__ == "__main__":
    app.run(debug=True, host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))

错误原因 #

• pylint是在Cloud Shell的本地Python环境中执行代码检查，而非Docker容器内部。Dockerfile里的pip install命令仅在构建容器时生效，只会给容器内部安装依赖，不会同步到Cloud Shell的本地环境。
• 本地环境缺少flask-smorest包，导致pylint无法找到该模块，抛出import-error。
• 注意：这个报错只是编辑器的代码检查提示，容器本身已安装依赖，实际运行Cloud Run服务时不会有问题。

解决方法 #

方法1：在Cloud Shell本地安装依赖 #

直接在Cloud Shell终端执行以下命令，给本地Python环境安装所需依赖：

pip install flask-smorest marshmallow Flask

安装完成后，pylint就能找到对应的模块，报错会消失。

方法2：配置pylint忽略该错误（无需本地安装依赖） #

如果不想在本地安装依赖，可以通过配置让pylint忽略这个导入错误：

• 方式一：在项目根目录创建.pylintrc文件，添加以下内容：

[MASTER]
ignored-modules=flask_smorest

• 方式二：在app.py的导入行添加注释，单独忽略该错误：

from flask_smorest import Api  # pylint: disable=import-error

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