Allure自定义标签在Pytest报告中不显示的问题咨询

环境 #

• python 3.12.2
• allure-pytest: 2.13.5
• allure-python-commons: 2.13.5
• pytest: 8.2.2
• allure CLI: 2.30.0

前提 #

根据Allure官方文档，可通过@allure.label()添加标签，支持LabelType常量或任意字符串。示例代码：

import allure

@allure.label("any other string", "python")
@allure.label("another any other string", "pytest")
def test_authentication():
    pass

问题 #

添加自定义标签（如Area、Component等）后，标签未在最终Allure报告中显示，但报告目录下的*-result.json文件中存在这些标签数据。同时，文档中使用LabelType.LANGUAGE的示例标签也未显示，仅@allure.title()等装饰器的内容正常显示。

已尝试方案 #

• 将自定义标签封装为单独装饰器函数
• 添加allure.properties配置并结合LabelType.CUSTOM_LABEL_*使用
• 自定义组合装饰器统一添加标签
  以上方案均未解决问题。

疑问 #

当前操作存在什么问题？是否可以为LabelType添加自定义属性？

问题原因及解决办法 #

1. Allure报告UI默认仅渲染预设标签类型
   Allure报告界面默认只展示官方预设的标签（如severity、epic、feature、story等），自定义字符串标签、LabelType.LANGUAGE这类非预设标签，即使数据已写入result.json，也不会自动在UI上显示。

2. 自定义标签显示的可行方案

方案一：使用官方预留的自定义标签字段

改用Allure提供的LabelType.CUSTOM_LABEL_*系列常量作为标签键，同时在配置文件中指定显示名称：

import allure
from allure_commons.types import LabelType

@allure.label(LabelType.CUSTOM_LABEL_1, "用户管理")
@allure.label(LabelType.CUSTOM_LABEL_2, "登录模块")
def test_login():
    assert True

在项目根目录创建allure.properties文件，添加配置：

allure.label.custom_label_1.name=Area
allure.label.custom_label_2.name=Component

重新生成报告后，Area和Component标签会正常显示在UI中。

方案二：自定义标签键+修改UI模板（进阶）

如果需要完全自定义标签键（如直接用"Area"作为键），需修改Allure的前端UI模板，让它识别并渲染指定标签。此方式需要具备前端开发基础，适合深度定制需求。

3. 关于LabelType添加自定义属性
   LabelType是枚举类，无法直接添加自定义属性。如果需要复用自定义标签键，可自行定义常量替代：

import allure

CUSTOM_LABELS = {
    "AREA": "area",
    "COMPONENT": "component"
}

@allure.label(CUSTOM_LABELS["AREA"], "用户管理")
@allure.label(CUSTOM_LABELS["COMPONENT"], "登录模块")
def test_login():
    pass

但这种方式仍需配合UI模板修改才能在报告中显示标签，否则仅能在result.json中查看数据。

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