## 01、痛点

每天早上一睁眼，先想起那件事：今天的学积分还没打。你手机里可能也有一个这样的网站：登录、签到、领积分，一天漏掉，连续奖励就断。朋友的公司甚至用积分排名考核学习，漏签一天，整个月的排序都受影响。

我是老李，写 Java 十多年了。遇到这种重复动作，我的第一反应不是更自律，而是找程序干。因为我知道，人的脑子是用来处理异常流程的，不是用来每天在同一个按钮上点来点去的。

可问题来了：平台上的打卡页面不是单纯的一两行接口，登录有校验、页面是动态渲染，有的还带滑块。写一个普通 HTTP 请求去“假装打卡”，会直接被拦截。怎么办？用浏览器自动化，让真的浏览器自己点。

这篇文章不绕弯，直接给你一个 Java 配 Playwright 的入门例子，解决“每日打卡领积分”这个需求。我会从环境怎么搭、代码怎么写、异常怎么兜底、定时怎么跑，一次性讲清。

## 02、是什么

Playwright 是微软开源的浏览器自动化库，支持 Chromium、Firefox、WebKit 三套浏览器引擎。简单说，它让你用代码控制浏览器，像人一样打开网页、输入账号密码、点击按钮、读取页面内容。

Java 不是玩票：官方提供 Java API，能直接丢进 Maven 工程，和 Spring 项目也不冲突。我们只需引入一个依赖，就能在本地起一个无头浏览器。

在 Maven 的 pom.xml 里加：

```xml
<dependency>
    <groupId>com.microsoft.playwright</groupId>
    <artifactId>playwright</artifactId>
    <version>1.43.0</version>
</dependency>
```

加完依赖后，第一次运行前还要下载浏览器。你可以在命令行执行：

```bash
mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="install chromium"
```

只要 chromium 就够了。这一步相当于把浏览器运行时下载到本地，和普通的浏览器安装包不是一回事。

看到这里你会发现：Playwright 并不是“又一个测试框架”，它本身就是一个浏览器操作器。你让它点谁，它就点谁；你让它填什么，它就填什么。

## 03、为什么

你可能会问：用 Java 写脚本，为什么非选 Playwright，而不是自己拼 HTTP 请求，或者用老牌工具？

三句话你感受一下。

第一，很多网站的前端是动态渲染的。数据埋在一堆 ajax 请求里，你拿接口地址、拼参数、处理签名，折腾半天，可能第二天页面改版就废了。用浏览器自动化，页面怎么变，你只需要关心“最终用户看到的界面元素”。

第二，Playwright 有自动等待能力。你写 `click` 后，它会自己在几秒内等元素出现、可点击、可见，而不是傻等三秒再硬点。这比很多人的 `Thread.sleep(3000)` 舒服太多了，也稳定得多。

第三，它和 Java 类型体系接得好。写的是 Java 代码，能用 try-with-resources，能强类型，能打日志，能接异常。做一个每天自动跑的任务，不是只跑一次，所以才需要这些工程能力。

为什么是现在？因为现在连挂机的门槛都在变高。很多平台会识别信息指纹，用户会用人机验证。如果手动操作，每天确实累；如果只靠接口，又过不去验证。唯一可行的个人方案，就是把浏览器自动化流程做对。这个时间窗口刚刚好：你还能用它练手，而不是等平台把漏洞都补完。

## 04、架构

每天打卡这个需求不大，但也别一上来就在 main 方法里堆。我习惯把任务拆成四层。

一层是“触发层”，负责第二天九点叫你。可以是操作系统的定时任务，也可以是 Spring 的 @Scheduled，还可以直接写一个 `while(true)` 加时间判断。如果是正式一点的项目，用 Cron 表达式更清晰。

二层是“浏览器操作层”，封装“打开页面、登录、进入打卡页、点击打卡、判断成功”这些动作。每个动作尽量独立，像积木一样拼。

三层是“结果处理层”，打卡成功就记录日志，失败就截个图。如果连续失败，就发一个提醒出来，邮件、钉钉、企业微信都行。

四层是“配置层”，URL、账号、密码、打卡按钮的选择器，不许写在 Java 代码里。一是脏，二是没法改，三是不安全。统一放到 `config.properties` 文件里，或者环境变量里。

整个流程可以画成这样：

```text
定时触发 -> 启动 Chromium -> 读取配置 -> 登录 -> 打卡 -> 校验结果 -> 写日志 / 发通知
```

架构不用复杂。越简单，越容易跑。

## 05、实战

下面给一个能跑的入门例子，你只需要改三处：URL、账号、打卡按钮。代码里我用环境变量接收用户名和密码，避免把敏感信息写死在代码里。

```java
import com.microsoft.playwright.Browser;
import com.microsoft.playwright.BrowserContext;
import com.microsoft.playwright.BrowserType;
import com.microsoft.playwright.Page;
import com.microsoft.playwright.Playwright;

public class CheckinJob {

    public static void main(String[] args) {
        String username = System.getenv("CHECKIN_USER");
        String password = System.getenv("CHECKIN_PASS");
        if (username == null || password == null) {
            throw new IllegalStateException("请先设置 CHECKIN_USER 和 CHECKIN_PASS");
        }

        try (Playwright playwright = Playwright.create()) {
            Browser browser = playwright.chromium().launch(new BrowserType.LaunchOptions()
                    .setHeadless(true));
            BrowserContext context = browser.newContext();
            Page page = context.newPage();

            page.navigate("https://example.com/login");
            page.fill("#username", username);
            page.fill("#password", password);
            page.click("#loginBtn");

            // 登录后等待用户面板出现，超时 10 秒
            page.waitForSelector(".user-panel", new Page.WaitForSelectorOptions().setTimeout(10_000));

            // 打卡
            page.click("text=每日打卡");

            // 等待成功提示
            page.waitForSelector(".checkin-success", new Page.WaitForSelectorOptions().setTimeout(10_000));

            System.out.println("打卡成功，积分已到账");

            // 留一张截图，方便以后排查
            page.screenshot(new Page.ScreenshotOptions().setPath(java.nio.file.Paths.get("checkin.png")));
        }
    }
}
```

这段代码最核心的是两件事：`fill` 负责填表单，`click` 负责点按钮。`waitForSelector` 是等一个元素出现，相当于告诉 Playwright：“看到这个元素，才算成功。”

注意 `text=每日打卡` 这种写法。它不依赖 CSS 类名，哪怕页面结构微调，只要按钮文案不变，代码还能跑。

正式跑之前，建议把 `setHeadless(true)` 改成 `false`。先别用无头模式，要肉眼看一遍浏览器操作过程，确认选择器没有找错。跑通之后，再改回 `true`。

另外，失败重试很关键。网络一抖，打卡就可能失败。可以给主流程加一个循环：

```java
public static void main(String[] args) throws Exception {
    int maxRetry = 3;
    for (int i = 1; i <= maxRetry; i++) {
        try {
            runCheckin();
            break;
        } catch (Exception e) {
            System.err.println("第 " + i + " 次打卡失败：" + e.getMessage());
            if (i == maxRetry) {
                throw e;
            }
            Thread.sleep(2_000L * i);
        }
    }
}
```

把原子操作抽成 `runCheckin()`，重试逻辑放在外层。第 1 次失败等 2 秒，第 2 次失败等 4 秒，最多试 3 次。

如果你打算用 Spring 的定时任务，也可以在方法上写：

```java
@Scheduled(cron = "0 30 8 * * *")
public void autoCheckin() {
    runCheckin();
}
```

这行的意思是每天 8:30 自动执行一次。

等等，还有两个隐藏坑。

一个是登录验证码。如果平台有图形验证码，第一步先别自动解，先手动登录一次，然后把登录态保存成 `storageState.json`。下次启动时直接加载这个文件，省掉重新登录。Playwright 的做法是：

```java
context.storageState(new BrowserContext.StorageStateOptions()
        .setPath(java.nio.file.Paths.get("storageState.json")));
```

下次不需要登录，直接：

```java
BrowserContext context = browser.newContext(new Browser.NewContextOptions()
        .setStorageStatePath(java.nio.file.Paths.get("storageState.json")));
```

这个“登录一次、长期复用”的方案，比我见过的任何验证码库都省事。

另一个是打卡按钮可能在 iframe 里。遇到这种情况，普通 `page.click` 找不到。解决办法是给 iframe 写一个选择器：

```java
page.frameLocator("#loginFrame").locator("text=每日打卡").click();
```

先定位 iframe，再继续找内部元素。这些不是花哨技巧，是真实做自动打卡时最容易踩的坑。

## 06、洞见

每天打卡领积分，本质上是一个“用确定性换不确定性”的过程：脚本按固定逻辑执行，用机器的方式接管重复操作。但你收获的绝对不只是每天的积分，而是“如何把一件小事做成靠谱的系统”的体感。

我看过很多人写自动化脚本，只写主流程，不做处理：没打卡成功不会截图，页面改版不会告警，运行失败不会重试。这种脚本只能碰运气，不能叫“不上班就自动打卡”。真正可靠，需要接受一个事实：网络会抖，元素会变，验证码会捣乱。你要做的，是把异常当作一条正常路径来设计。

另外一个重要的洞见是：不要一上来就求全。你在头一版只要做到“今天早上替你把打卡点了”就够了。等你能稳定跑三天，再慢慢加“失败通知”，加“每日截图”，加“调监控”。自动化是一步步逼近的，不是一次写出来的。

说到头，这件事的价值不在积分的几分钱，而在于你在训练自己：把问题拆成可执行动作，然后交给程序去跑。这是技术人最值钱的肌肉记忆。

## 07、行动

如果你看完心动了，接下来可以按下面六步走。

第一步，打开你要打卡的网站，用浏览器把完整的打卡流程走一遍。注意每一步的 URL、按钮文案、输入框的 id 或 name。最好截一张图。

第二步，建一个 Maven 项目，加入 Playwright 依赖。这一步不会超过十分钟。

第三步，在本地运行一个小例子，只做登录。登录成功后打印一句日志。

第四步，在登录基础上加打卡动作，并且把登录和打卡都用 `waitForSelector` 守住。保证“看到结果才算成功”。

第五步，把账号密码改成环境变量，加上失败截图和重试机制。让程序在出错的时候留下证据。

第六步，设置定时任务。如果你用的是 Spring，直接加 `@Scheduled`；如果你是简单 Java 项目，就用系统的 Cron 或者 Windows 任务计划。

不要试图一步到位。第一步可以先在电脑前盯着它跑，连续两天成功以后，再把它丢到没人管的角落。到这一步，你才真正体验到“躺赚积分”的快乐。

## 08、小结

有一句话我很喜欢：自动化不是让你越来越懒，而是让你把注意力从“重复操作”上释放出来。

当你不用再记着每天九点打卡，不用再怕断签，你心里就少一根弦。省下的五分钟看起来不多，但省下的是“不得不做”的焦虑。

写代码的人，最应该给自己的礼物，就是让程序替自己记住那些小事。今天这个 Java 打卡例子，不是终点，是一个开始。你可以改一改，把它用到其他任务上：自动提交周报、自动刷新库存、自动清理日志。人能少做一件琐事，就多一段专注的时间。这很值。

## 09、链接与概念说明

这一节把文中几个关键概念讲清楚，别混。

Playwright：微软开源的浏览器自动化工具。支持 Java、Python、Node.js、.NET。官方地址：playwright.dev/java。

无头浏览器：不显示界面、只在后台运行的浏览器。适合服务器环境和定时任务，但调试时不建议开。

自动等待：执行点击、输入前，Playwright 会持续检查元素的状态，直到可操作或超时。不用像老脚本那样随手写 `Thread.sleep`。

storageState：浏览器的登录状态文件。包括 Cookie、本地存储等。把首次登录后的状态存下来，以后复用，就是“免登录”的底层原理。

Web 定位器：选择元素的表达式，比如 `#username` 是 id，`.user-panel` 是类名，`text=每日打卡` 是文本内容。优先用文本定位，因为改版时文案一般不会变。

iframe：页面嵌套的另一个网页。要在 iframe 里操作，先用 `frameLocator` 定位，再继续找元素。

如果你想继续深入，推荐研究：
- Playwright 官方文档的 Java 入门部分；
- BrowserContext 与 Cookie 的关系；
- CSS 选择器和 XPath 的区别；
- 如何给定时任务增加运行日志轮转。

到此，你已经有一个能跑的骨架了。剩下的事情，就是每天看它的运行记录，看积分有没有到账。到这一步，剩下的事情交给时间。

每天早上一睁眼，先想起那件事：今天的学积分还没打。你手机里可能也有一个这样的网站：登录、签到、领积分，一天漏掉，连续奖励就断。朋友的公司甚至用积分排名考核学习，漏签一天，整个月的排序都受影响。

Java版Playwright：每天自动打卡领积分，这个入门例子拿走就用

用Java写每日自动打卡脚本，从环境准备到代码实现再到重试和定时，一步到位。

架构师

人工智能

Java+Playwright实现每日自动打卡领积分，解决登录校验、动态渲染和滑块验证难题。提供完整Maven配置、无头浏览器操作、自动等待机制、失败重试和定时任务方案，支持登录态复用与iframe处理，助你构建稳定可靠的自动化打卡系统。

代码解释

验证码

服务器

Windows

Python

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Java版Playwright：每天自动打卡领积分，这个入门例子拿走就用-腾讯云开发者社区-腾讯云

Java版Playwright：每天自动打卡领积分，这个入门例子拿走就用

Java版Playwright：每天自动打卡领积分，这个入门例子拿走就用

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐