Java远程调用Liferay /user/update-user API失败，报NoSuchJSONWebServiceException

我来帮你搞定这个Liferay JSON Web Service调用的问题，你遇到的错误No JSON web service action with path /user/update-user and method POST for null本质是Liferay找不到你指定的POST接口，其中的for null提示大概率和请求上下文、权限缺失或者参数错误有关。下面是几个靠谱的排查方向和解决办法：

1. 先确认接口的正确性：查Liferay自带的JSON WS控制台 #

Liferay每个版本的JSON WS接口可能略有差异，别自己瞎猜路径！直接登录你的Liferay后台，访问/api/jsonws页面（比如http://your-liferay-domain:8080/api/jsonws），找到User服务，然后找更新用户的方法：

• 确认方法的路径是不是/user/update-user（有些版本可能是/user/update）
• 确认这个方法支持的HTTP方法是不是POST
• 记下所有必填参数（比如userId、companyId这些肯定是少不了的）

2. 检查身份验证和权限 #

这个接口不是谁都能调用的，必须用有用户管理权限的账号（比如管理员）进行身份验证：

• 如果你用的是Basic Auth，要在请求头里加上Authorization: Basic <base64编码的用户名:密码>
• 如果是OAuth2，确保请求头里带了有效的Authorization: Bearer <token>
• 没有正确验证的话，Liferay会把你当成匿名用户，匿名用户根本看不到这个接口，自然会报“找不到”的错误

3. 核对请求参数和格式 #

缺少必填参数或者参数格式不对，也会导致Liferay匹配不到正确的接口方法：

• 必须传递userId（要更新的用户ID）和companyId（你的Liferay实例的公司ID，一般是1）
• 请求体必须是JSON格式，并且设置请求头Content-Type: application/json
• 别把参数名写错了，比如把userId写成userid，Liferay认不出来的

4. 检查Java调用代码的细节 #

给你一个正确的Java调用示例（用Apache HttpClient），对照着看看你的代码哪里错了：

import org.apache.http.HttpHeaders;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.commons.codec.binary.Base64;
import org.json.JSONObject;
import java.nio.charset.StandardCharsets;

public class LiferayUserUpdate {
    public static void main(String[] args) throws Exception {
        CloseableHttpClient httpClient = HttpClients.createDefault();
        // 注意：这里的路径要和JSON WS控制台里的一致
        HttpPost httpPost = new HttpPost("http://your-liferay-domain:8080/api/jsonws/user/update-user");

        // 设置Basic Auth身份验证
        String username = "admin@liferay.com";
        String password = "your-admin-password";
        String auth = username + ":" + password;
        byte[] encodedAuth = Base64.encodeBase64(auth.getBytes(StandardCharsets.UTF_8));
        String authHeader = "Basic " + new String(encodedAuth);
        httpPost.setHeader(HttpHeaders.AUTHORIZATION, authHeader);

        // 设置JSON请求头
        httpPost.setHeader(HttpHeaders.CONTENT_TYPE, "application/json");

        // 构造请求体，包含必填参数和要更新的字段
        JSONObject requestBody = new JSONObject();
        requestBody.put("userId", 12345); // 替换成你要更新的用户ID
        requestBody.put("companyId", 1); // 替换成你的Liferay公司ID
        requestBody.put("emailAddress", "new-user-email@example.com"); // 要更新的字段

        StringEntity entity = new StringEntity(requestBody.toString());
        httpPost.setEntity(entity);

        // 发送请求并处理响应
        try (CloseableHttpResponse response = httpClient.execute(httpPost)) {
            System.out.println("Response Status: " + response.getStatusLine());
            // 这里可以进一步读取响应内容
        }
    }
}

5. 检查Liferay版本兼容性 #

如果你用的是Liferay 7.x和6.x，接口路径和参数可能有差异，比如6.x里的某些接口在7.x里被调整了。一定要确保你的调用代码和你使用的Liferay版本匹配。

按照上面的步骤排查，应该就能解决这个问题了！

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