为何切换到mstrio dashboard仍出现弃用警告？警告过滤无效怎解决？

为什么警告无法消除？ #

核心原因是 mstrio.project_objects.dashboard 模块内部导入了已被弃用的 dossier 模块——警告并非来自你导入dashboard的操作，而是dashboard加载时，其内部对dossier的导入触发的。常规过滤失效通常是因为：

• 过滤规则的生效时机晚于警告触发时机（模块加载时警告已发出，过滤还没生效）
• 正则匹配的细节（如转义字符）导致规则未命中警告信息

如何避免该弃用警告？ #

方案1：代码内提前精准过滤 #

在导入dashboard前先配置警告过滤，确保规则在模块加载前生效：

import warnings
# 用原始字符串避免转义问题，精准匹配警告内容
warnings.filterwarnings(
    "ignore",
    category=DeprecationWarning,
    message=r".*mstrio\.project_objects\.dossier module is deprecated.*"
)
from mstrio.project_objects import dashboard

方案2：命令行全局忽略（脚本场景） #

如果是通过命令行执行，调整PYTHONWARNINGS或使用-W参数，确保匹配规则覆盖该警告：

# 方法一：通过环境变量
export PYTHONWARNINGS='ignore::DeprecationWarning:mstrio.project_objects.dossier'
python3 -c 'from mstrio.project_objects import dashboard'

# 方法二：直接通过-W参数
python3 -W "ignore:.*mstrio.project_objects.dossier module is deprecated.*:DeprecationWarning" -c "from mstrio.project_objects import dashboard"

方案3：交互式环境清空模块缓存重试 #

在Python shell或IPython等交互式环境中，若模块已被缓存，过滤规则可能无法生效，可先清空缓存再重新导入：

import sys
import warnings

# 删除已缓存的相关模块
for mod in ['mstrio.project_objects.dashboard', 'mstrio.project_objects.dossier']:
    if mod in sys.modules:
        del sys.modules[mod]

# 重新设置过滤并导入
with warnings.catch_warnings():
    warnings.filterwarnings("ignore", category=DeprecationWarning, message=r".*dossier module is deprecated.*")
    from mstrio.project_objects import dashboard

补充 #

当前使用的11.4.3.101版本中，dashboard模块仍依赖dossier，官方将在11.5.03及以上版本移除该依赖，届时此警告会自动消失。

内容的提问来源于stack exchange，提问作者no step on snek