Puppeteer报错：未找到选择器#txtKyoushuuseiNO，求排查

1. 元素可能嵌套在iframe中 #

很多登录页面会把表单放在iframe里，Puppeteer默认不会自动切换到iframe上下文。先检查页面是否存在iframe，再切换上下文操作元素：

// 方式1：通过URL关键词定位iframe
const frame = await page.waitForFrame(frame => frame.url().includes('目标iframe的URL关键词'));
// 方式2：通过选择器定位iframe元素后获取上下文
const iframeElement = await page.waitForSelector('iframe的CSS选择器');
const frame = await iframeElement.contentFrame();

// 切换后用frame代替page操作输入框
await frame.type('#txtKyoushuuseiNO', username);
await frame.type('#txtPassword', password);

2. 元素为动态渲染，需等待元素可见 #

networkidle0仅代表网络请求完成，但DOM元素可能还未渲染完毕，需先等待目标元素加载可见：

await page.goto('https://kds-net.obic7.obicnet.ne.jp/ZADMbl/MainFrame.aspx', { waitUntil: 'networkidle0' });
// 等待用户名输入框可见
await page.waitForSelector('#txtKyoushuuseiNO', { visible: true });
await page.type('#txtKyoushuuseiNO', username);
// 等待密码输入框可见
await page.waitForSelector('#txtPassword', { visible: true });
await page.type('#txtPassword', password);

3. waitForNavigation调用时机错误 #

当前代码输入密码后直接调用waitForNavigation，但未触发登录提交动作（如点击登录按钮），会导致等待超时。需先触发提交再等待导航：

// 输入账号密码后，点击登录按钮
await page.click('#登录按钮的CSS选择器'); // 替换为实际登录按钮的选择器
// 等待页面跳转完成
await page.waitForNavigation({ waitUntil: 'networkidle0' });

4. 网站存在反爬检测 #

部分网站会识别Puppeteer特征，可添加模拟浏览器配置规避：

const browser = await puppeteer.launch({
    headless: false,
    args: [
        '--disable-blink-features=AutomationControlled',
        '--user-agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36"'
    ]
});

// 页面加载前禁用自动化标识
await page.evaluateOnNewDocument(() => {
    Object.defineProperty(navigator, 'webdriver', {
        get: () => undefined,
    });
});

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