xpzouying/xiaohongshu-mcp · error

元素无可悬停区域

Error message

元素无可悬停区域

What it means

Raised in Hover (humanize/input.go:139) when the element's Shape() has no quads, so there is no hoverable area. The humanized hover needs quad geometry to compute a center and jitter target; a zero-quad shape means the browser cannot provide a box for the element.

Source

Thrown at humanize/input.go:139

	mouse := elem.Page().Mouse
	if err := moveMouseCurved(mouse, target); err != nil {
		return err
	}
	return pressAndRelease(mouse)
}

func MoveTo(page *rod.Page, pt proto.Point) error {
	return moveMouseCurved(page.Mouse, pt)
}

func Hover(elem *rod.Element) error {
	shape, err := elem.Shape()
	if err != nil {
		return err
	}
	if len(shape.Quads) == 0 {
		return errors.New("元素无可悬停区域")
	}

	q := shape.Quads[0]
	center := proto.Point{X: (q[0] + q[4]) / 2, Y: (q[1] + q[5]) / 2}

	target := jitterInQuad(center, q)
	if err := ensureClickable(elem, target); err != nil {
		return err
	}

	return moveMouseCurved(elem.Page().Mouse, target)
}

func ClickAt(page *rod.Page, pt proto.Point) error {
	if err := ensurePointInViewport(page, pt); err != nil {
		return err
	}
	if err := moveMouseCurved(page.Mouse, pt); err != nil {

View on GitHub (pinned to 332d196854)

Solutions

1. Wait until the target is rendered (WaitVisible + WaitStable) before Hover
2. Re-query the element inside the current DOM, especially after infinite-scroll updates
3. Skip elements with no geometry — filter result items by bounding box before hovering
4. Add humanized delays so lazy-rendered content has time to appear before the hover

Example fix

// before
card, _ := page.Element(".note-item")
humanize.Hover(card)
// after
card, _ := page.WaitVisible(".note-item")
page.WaitStable()
humanize.Hover(card)

shape, err := elem.Shape()
if err == nil && len(shape.Quads) > 0 { /* hoverable area exists */ }

func hasHoverArea(elem *rod.Element) bool {
    s, err := elem.Shape()
    return err == nil && len(s.Quads) > 0
}

if err := humanize.Hover(card); err != nil {
    if strings.Contains(err.Error(), "无可悬停区域") {
        return nil // skip item with no geometry
    }
    return err
}

When it happens

Trigger: Calling humanize.Hover on a hidden (display:none), detached, or zero-size element — `len(shape.Quads) == 0` triggers the error. In this repo it is called from Search when hovering search results.

Common situations: Hovering a search-result card while the list is still rendering or was virtualized away; hovering elements inside collapsed containers; stale handles after DOM updates during scraping.

Related errors

• 元素无可点击区域
• 元素当前不可命中
• 获取新版发布按钮位置失败: 无可点击区域
• 未找到评论输入框，该帖子可能不支持评论或网页端不可访问: %w
• 无法点击评论输入框: %w

AI-assisted analysis of xpzouying/xiaohongshu-mcp@332d196854 (2026-09-05). Data as JSON: /api/errors/5af5e26429f31857. Report an issue: GitHub.