Function run_token_maintenance_api

app/admin/api.py:804–866

立即执行一次 Token 维护。

(request: Request)

@router.post("/tokens/maintenance/run", dependencies=[Depends(require_auth)])
async def run_token_maintenance_api(request: Request):
    """立即执行一次 Token 维护。"""
    from app.core.config import settings
    from app.services.token_automation import run_token_maintenance

    form_data = await request.form()
    action_fields = (
        "auto_remove_duplicates",
        "auto_health_check",
        "auto_delete_invalid",
    )
    has_explicit_actions = any(field in form_data for field in action_fields)

    if has_explicit_actions:
        remove_duplicates = "auto_remove_duplicates" in form_data
        run_health_check = "auto_health_check" in form_data
        delete_invalid = "auto_delete_invalid" in form_data
    else:
        remove_duplicates = settings.TOKEN_AUTO_REMOVE_DUPLICATES
        run_health_check = settings.TOKEN_AUTO_HEALTH_CHECK
        delete_invalid = settings.TOKEN_AUTO_DELETE_INVALID

    if not any((remove_duplicates, run_health_check, delete_invalid)):
        return _build_alert(
            "当前没有可执行的维护动作，请先到 /admin/config#tokens 配置至少一个维护动作。",
            title="未执行维护！",
            level="warning",
            status_code=400,
        )

    try:
        summary = await run_token_maintenance(
            provider=DEFAULT_TOKEN_NAMESPACE,
            remove_duplicates=remove_duplicates,
            run_health_check=run_health_check,
            delete_invalid_tokens=delete_invalid,
        )
    except RuntimeError as exc:
        return _build_alert(
            str(exc),
            title="维护稍后重试",
            level="warning",
            status_code=409,
        )
    except Exception as exc:
        logger.exception(f"❌ 手动执行 Token 维护失败: {exc}")
        return _build_alert(
            f"Token 维护失败: {exc}",
            title="维护失败！",
            level="error",
            status_code=500,
        )

    return _build_alert(
        (
            f"本次维护共去重 {summary.duplicate_removed_count} 个，"
            f"测活 {summary.checked_count} 个（有效 {summary.valid_count} / "
            f"匿名 {summary.guest_count} / 无效 {summary.invalid_count}），"