Flask-AppBuilder自定义OAuth登录插件创建安装报错排查

看起来你遇到的核心问题是Python解释器找不到你的插件模块，这是因为你的插件目录没有被添加到Python的模块搜索路径（sys.path）里。下面是一步步的解决办法：

1. 正确安装你的插件到Python环境 #

仅仅把插件目录放在主项目同级或内部是不够的，Python不会自动识别未安装的目录作为可导入模块。你需要用pip以开发模式安装插件，这样既可以让Python找到模块，又能在修改插件代码后实时生效：

# 切换到插件的根目录（包含setup.py的那个fab_addon_x文件夹）
cd /path/to/fab_addon_x
# 用开发模式安装
pip install -e .

开发模式安装会在Python的site-packages目录里创建一个指向你插件源码的链接，确保解释器能找到fab_addon_x模块。

2. 验证插件的setup.py配置正确 #

你的插件骨架是用fabmanager生成的，但需要确认setup.py里的关键配置没问题，否则安装后模块依然无法被识别。检查你的setup.py是否包含以下内容：

from setuptools import setup, find_packages

setup(
    name='fab_addon_x',  # 必须和你的插件包名一致
    version='0.0.1',
    packages=find_packages(),  # 自动识别所有子包
    include_package_data=True,  # 确保templates、translations等非Python文件被包含
    install_requires=[
        'flask-appbuilder',  # 依赖Flask-AppBuilder
    ],
)

find_packages()会自动找到你插件目录下的fab_addon_x子包（里面有__init__.py、manager.py等文件），这是确保模块能被导入的关键。

3. 确认ADDON_MANAGERS的路径正确 #

确保你的config.py里的路径和插件的包结构完全匹配：

# 插件包是fab_addon_x，manager.py里的类是X
ADDON_MANAGERS = ['fab_addon_x.manager.X']

如果之前你把插件放在主项目内部（/myapp/fab_addon_x/），那路径应该改成'myapp.fab_addon_x.manager.X'，但更推荐用独立安装的方式，保持插件和主应用分离。

4. 验证模块是否可导入 #

在安装插件后，打开Python交互终端测试：

import fab_addon_x
from fab_addon_x.manager import X

如果没有报错，说明模块已经能被Python正确识别，此时再启动你的Flask-AppBuilder应用，应该就不会出现ModuleNotFoundError了。

额外排查点 #

• 如果你用了虚拟环境，确保你是在对应的虚拟环境里安装的插件，并且启动应用时也激活了这个虚拟环境。
• 检查插件目录下的fab_addon_x子目录是否存在__init__.py文件（即使是空文件也可以），没有这个文件的话Python不会把它当作一个可导入的包。

内容的提问来源于stack exchange，提问作者sj.meyer