Discuz! 的登录机制根据其版本不同有所区别，但核心都围绕着 Cookie 和 POST 请求，现代的 Discuz! X 及以上版本通常使用 formhash 来防止 CSRF 攻击,这是登录成功的关键。
（图片来源网络，侵删）
下面我将分步讲解，并提供一个完整的 Java 示例。
核心概念
- 登录 URL：这是用户提交用户名和密码的地址，通常是
你的域名/member.php?mod=logging&action=login&loginsubmit=yes&infloat=yes&lssubmit=yes。 - POST 参数：登录表单提交的数据，主要包括：
username: 用户名password: 密码（Discuz 通常会要求提供一个password和一个password2，或者直接使用password字段）formhash: 这是一个至关重要的参数，它是一个动态生成的令牌，用于验证请求的合法性，没有它,登录一定会失败。referer: 登录来源页面,通常是论坛首页。
- Cookie：登录成功后，Discuz! 服务器会在响应头中返回一个
Set-Cookie，这个 Cookie 是你身份的凭证，之后所有需要登录状态的请求（如发帖、回帖）都必须带上这个 Cookie。 - User-Agent：模拟一个真实的浏览器访问，Discuz! 有一些简单的反爬虫机制，设置一个常见的浏览器 User-Agent 可以避免被轻易识别为爬虫。
实现步骤
第一步：获取 formhash
在登录之前，你必须先访问登录页面，从 HTML 源码中解析出 formhash 的值。
- 发送一个
GET请求到登录页面（不带loginsubmit=yes参数）。 - 获取返回的 HTML 内容。
- 使用正则表达式或 HTML 解析器（如 Jsoup）从 HTML 中找到
<input type="hidden" name="formhash" value="...">标签，提取value的值。
第二步：执行登录
获取到 formhash 后,你就可以构造登录请求了。
- 创建一个
HttpPost请求，目标 URL 是第一步中的登录 URL。 - 设置请求头：
User-Agent: 设置为如Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36。Content-Type: 设置为application/x-www-form-urlencoded。Referer: 设置为论坛的首页 URL。
- 设置请求体（
Entity），将username,password,formhash等参数拼接成key=value&key2=value2的形式。 - 执行请求，并保存服务器返回的 Cookie，这通常通过一个
CookieStore来实现。
第三步：验证登录是否成功
登录请求执行后,你需要判断是否成功。
（图片来源网络，侵删）
- 方法一（推荐）：登录成功后，Discuz! 通常会重定向到首页，你可以检查响应的状态码，如果是
302或301，并且重定向地址是首页,则基本可以认为登录成功。 - 方法二：登录成功后，你可以尝试访问一个需要登录才能查看的页面（例如个人中心），如果页面能正常返回内容,则说明登录成功。
完整 Java 示例 (使用 Apache HttpClient 4.x)
这个例子将完整地展示上述三个步骤，你需要先添加 HttpClient 的依赖。
添加 Maven 依赖
在你的 pom.xml 文件中加入：
<dependencies>
<!-- Apache HttpClient -->
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.5.13</version> <!-- 使用较新或稳定的版本 -->
</dependency>
<!-- 用于解析 HTML 获取 formhash -->
<dependency>
<groupId>org.jsoup</groupId>
<artifactId>jsoup</artifactId>
<version>1.15.3</version>
</dependency>
</dependencies>
Java 代码实现
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.CookieStore;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.client.protocol.HttpClientContext;
import org.apache.http.cookie.Cookie;
import org.apache.http.impl.client.BasicCookieStore;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
import org.jsoup.nodes.Element;
import org.jsoup.select.Elements;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
public class DiscuzLogin {
// 替换为你的论坛地址
private static final String BASE_URL = "http://your-discuz-domain.com";
private static final String LOGIN_URL = BASE_URL + "/member.php?mod=logging&action=login";
private static final String LOGIN_ACTION_URL = BASE_URL + "/member.php?mod=logging&action=login&loginsubmit=yes&infloat=yes&lssubmit=yes";
private static final String USERNAME = "your_username";
private static final String PASSWORD = "your_password";
public static void main(String[] args) {
// 1. 创建一个 CookieStore 来保存登录后的 Cookie
CookieStore cookieStore = new BasicCookieStore();
// 2. 创建 HttpClientContext 并设置 CookieStore
HttpClientContext context = HttpClientContext.create();
context.setCookieStore(cookieStore);
// 3. 创建 HttpClient
try (CloseableHttpClient httpClient = HttpClients.custom().setDefaultCookieStore(cookieStore).build()) {
// --- 第一步：获取 formhash ---
String formhash = getFormhash(httpClient, context);
if (formhash == null) {
System.err.println("获取 formhash 失败，程序退出。");
return;
}
System.out.println("成功获取 formhash: " + formhash);
// --- 第二步：执行登录 ---
boolean loginSuccess = performLogin(httpClient, context, formhash);
if (loginSuccess) {
System.out.println("登录成功！");
// --- 第三步：验证登录状态 ---
verifyLoginStatus(httpClient, context);
} else {
System.err.println("登录失败！");
}
} catch (IOException e) {
e.printStackTrace();
}
}
/**
* 访问登录页面，获取 formhash
*/
private static String getFormhash(CloseableHttpClient httpClient, HttpClientContext context) throws IOException {
HttpGet httpGet = new HttpGet(LOGIN_URL);
httpGet.setHeader("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36");
try (CloseableHttpResponse response = httpClient.execute(httpGet, context)) {
HttpEntity entity = response.getEntity();
String html = EntityUtils.toString(entity);
// 使用 Jsoup 解析 HTML
Document doc = Jsoup.parse(html);
Element formhashElement = doc.select("input[name=formhash]").first();
if (formhashElement != null) {
return formhashElement.attr("value");
}
}
return null;
}
/**
* 执行登录操作
*/
private static boolean performLogin(CloseableHttpClient httpClient, HttpClientContext context, String formhash) throws IOException {
HttpPost httpPost = new HttpPost(LOGIN_ACTION_URL);
// 设置请求头
httpPost.setHeader("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36");
httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded");
httpPost.setHeader("Referer", BASE_URL + "/member.php?mod=logging&action=login");
// 设置请求体
List<NameValuePair> params = new ArrayList<>();
params.add(new BasicNameValuePair("formhash", formhash));
params.add(new BasicNameValuePair("referer", BASE_URL + "/"));
params.add(new BasicNameValuePair("username", USERNAME));
params.add(new BasicNameValuePair("password", PASSWORD));
params.add(new BasicNameValuePair("loginsubmit", "yes"));
// Discuz! X 3.4 等版本可能还需要这两个参数，如果上面的不行可以尝试加上
// params.add(new BasicNameValuePair("fastloginfield", "username"));
// params.add(new BasicNameValuePair("questionid", "0"));
// params.add(new BasicNameValuePair("answer", ""));
httpPost.setEntity(new UrlEncodedFormEntity(params, "UTF-8"));
try (CloseableHttpResponse response = httpClient.execute(httpPost, context)) {
// 检查响应状态码，登录成功通常会返回 302 重定向
int statusCode = response.getStatusLine().getStatusCode();
if (statusCode == 302) {
System.out.println("登录请求成功，服务器返回重定向。");
return true;
} else {
// 如果不是 302，可以打印响应内容看看错误信息
HttpEntity entity = response.getEntity();
String responseBody = EntityUtils.toString(entity);
System.err.println("登录失败，状态码: " + statusCode);
System.err.println("响应内容: " + responseBody);
return false;
}
}
}
/**
* 验证登录状态，访问需要登录的页面
*/
private static void verifyLoginStatus(CloseableHttpClient httpClient, HttpClientContext context) throws IOException {
// 访问个人中心页面，这个页面需要登录
HttpGet httpGet = new HttpGet(BASE_URL + "/space.php?uid=1"); // uid=1 通常是管理员或第一个用户
httpGet.setHeader("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36");
try (CloseableHttpResponse response = httpClient.execute(httpGet, context)) {
int statusCode = response.getStatusLine().getStatusCode();
if (statusCode == 200) {
HttpEntity entity = response.getEntity();
String html = EntityUtils.toString(entity);
// 简单判断页面内容是否包含用户名，证明已登录
if (html.contains(USERNAME)) {
System.out.println("验证成功：成功访问需要登录的页面，页面内容包含用户名。");
} else {
System.out.println("验证失败：访问了页面，但内容不包含用户名，可能登录有问题。");
}
} else {
System.err.println("验证失败：无法访问需要登录的页面，状态码: " + statusCode);
}
}
// 打印当前保存的所有 Cookie
System.out.println("\n当前保存的 Cookie:");
for (Cookie cookie : context.getCookieStore().getCookies()) {
System.out.println(cookie.getName() + " = " + cookie.getValue());
}
}
}
重要提示和常见问题
-
Discuz! 版本差异：
- Discuz! 7.x 及以下：登录机制可能更简单，不一定需要
formhash，你可以尝试直接提交username和password。 - Discuz! X 2.5 / 3.4 / 3.4+：上述代码基本适用，但
POST参数的名称可能略有不同，如果登录失败，最好使用浏览器开发者工具（F12）的 "Network" 面板，手动登录一次，然后查看login请求的Payload或Form Data，确保你的 Java 代码中的参数名和值完全一致。
- Discuz! 7.x 及以下：登录机制可能更简单，不一定需要
-
验证码：
（图片来源网络，侵删）如果论坛开启了登录验证码，上述代码将无法登录，你需要先实现验证码的识别（如使用 OCR 库 Tesseract）或通过第三方打码平台。
-
HTTPS：
- 如果你的论坛使用
https，请将BASE_URL等地址中的http替换为https。HttpClient默认支持 HTTPS。
- 如果你的论坛使用
-
编码问题：
确保你的论坛和 Java 代码都使用 UTF-8 编码,以避免中文用户名或密码出现乱码。
-
会话保持：
HttpClientContext和CookieStore的配合使用是关键，一旦你用它们执行了第一个请求，后续所有通过同一个context发起的请求都会自动带上之前保存的 Cookie,从而保持登录会话。
