Skip to content

优化小程序订阅消息字符串处理 #4049

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
binarywang merged 2 commits into from
Jun 8, 2026
+127 −1
Merged

优化小程序订阅消息字符串处理 #4049

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2c0a44d
优化小程序订阅消息字符串处理
buaazyl Jun 8, 2026
6baa992
优化小程序订阅消息参数值处理
buaazyl Jun 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
128 changes: 127 additions & 1 deletion weixin-java-miniapp/src/main/java/cn/binarywang/wx/miniapp/bean/WxMaSubscribeMessage.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,12 @@
import cn.binarywang.wx.miniapp.json.WxMaGsonBuilder;
import lombok.*;
import lombok.experimental.Accessors;
import org.apache.commons.lang3.StringUtils;

import java.io.Serializable;
import java.util.ArrayList;
import java.util.List;
import java.util.regex.Pattern;

/**
* 订阅消息
Expand All @@ -24,6 +26,19 @@
public class WxMaSubscribeMessage implements Serializable {
private static final long serialVersionUID = 6846729898251286686L;

/**
* 预编译正则，避免每次调用 resetValue 时重复编译
*/
private static final Pattern NUMBER_PATTERN = Pattern.compile("[^0-9.\\-]");
private static final Pattern NUMBER_VALID_PATTERN = Pattern.compile("-?\\d+\\.?\\d*|-?\\.\\d+");
private static final Pattern LETTER_PATTERN = Pattern.compile("[^a-zA-Z]");
private static final Pattern SYMBOL_PATTERN = Pattern.compile("[a-zA-Z0-9\\u4e00-\\u9fa5]");
private static final Pattern PHONE_PATTERN = Pattern.compile("[^0-9+\\-]");
private static final Pattern NAME_PATTERN = Pattern.compile("[^\\u4e00-\\u9fa5a-zA-Z \\u00b7.\\u3001\\uff0c\\u3002\\-]");
private static final Pattern CHARACTER_STRING_PATTERN = Pattern.compile("[\\u4e00-\\u9fa5]");
private static final Pattern CHINESE_PATTERN = Pattern.compile("[\\u4e00-\\u9fa5]");
private static final Pattern PHRASE_PATTERN = Pattern.compile("[^\\u4e00-\\u9fa5]");

/**
* 接收者（用户）的 openid.
* <pre>
Expand Down Expand Up @@ -75,15 +90,126 @@ public class WxMaSubscribeMessage implements Serializable {
private String lang = WxMaConstants.MiniProgramLang.ZH_CN;

public WxMaSubscribeMessage addData(MsgData datum) {
if (datum == null) {
return this;
}
if (this.data == null) {
this.data = new ArrayList<>();
}

this.data.add(datum);
this.data.add(resetValue(datum));
Comment thread
buaazyl marked this conversation as resolved.
Comment thread
binarywang marked this conversation as resolved.

return this;
}

/**
* 处理订阅消息字符串长度及格式问题
*
* @link <a href="https://developers.weixin.qq.com/miniprogram/dev/server/API/mp-message-management/subscribe-message/api_sendmessage.html">发送订阅消息</a>
*/
private MsgData resetValue(MsgData datum) {
String name = datum.getName();
String value = datum.getValue();

if (StringUtils.isBlank(value)) {
// 空值会发送失败，改为-
datum.setValue("-");
return datum;
Comment thread
binarywang marked this conversation as resolved.
}

if (StringUtils.startsWith(name, "thing") && value.length() > 20) {
// thing.DATA: 20个以内字符，可汉字、数字、字母或符号组合
value = StringUtils.substring(value, 0, 17) + "...";
} else if (StringUtils.startsWith(name, "number")) {
// number.DATA: 32位以内数字，只能数字，可带小数
value = NUMBER_PATTERN.matcher(value).replaceAll("");
if (!NUMBER_VALID_PATTERN.matcher(value).matches()) {
value = "0";
}
if (value.length() > 32) {
value = StringUtils.substring(value, 0, 32);
}
} else if (StringUtils.startsWith(name, "letter")) {
// letter.DATA: 32位以内字母，只能字母
value = LETTER_PATTERN.matcher(value).replaceAll("");
if (value.isEmpty()) {
value = "A";
}
if (value.length() > 32) {
value = StringUtils.substring(value, 0, 32);
}
} else if (StringUtils.startsWith(name, "symbol")) {
// symbol.DATA: 5位以内符号，只能符号（除中文、英文、数字外的常见符号）
value = SYMBOL_PATTERN.matcher(value).replaceAll("");
if (value.isEmpty()) {
value = "-";
}
if (value.length() > 5) {
value = StringUtils.substring(value, 0, 5);
}
} else if (StringUtils.startsWith(name, "character_string")) {
// character_string.DATA: 32位以内，可数字、字母或符号组合（不含中文）
value = CHARACTER_STRING_PATTERN.matcher(value).replaceAll("");
if (value.isEmpty()) {
value = "0";
}
if (value.length() > 32) {
value = StringUtils.substring(value, 0, 32);
}
} else if (StringUtils.startsWith(name, "phone_number")) {
// phone_number.DATA: 17位以内，数字、符号
value = PHONE_PATTERN.matcher(value).replaceAll("");
// 只允许一个前导+号，且必须在开头
if (value.startsWith("+")) {
value = "+" + value.substring(1).replace("+", "");
} else {
value = value.replace("+", "");
}
if (value.isEmpty()) {
value = "0";
}
if (value.length() > 17) {
value = StringUtils.substring(value, 0, 17);
}
} else if (StringUtils.startsWith(name, "car_number")) {
// car_number.DATA: 8位以内，第一位与最后一位可为汉字，其余为字母或数字
if (value.length() > 8) {
value = StringUtils.substring(value, 0, 8);
}
} else if (StringUtils.startsWith(name, "name")) {
// name.DATA: 10个以内纯汉字或20个以内纯字母或符号，中文和字母混合按中文名算10个字内
// 过滤非法字符，不保留数字（name 类型不允许数字）
value = NAME_PATTERN.matcher(value).replaceAll("");
if (value.isEmpty()) {
value = "-";
}
boolean containsChinese = CHINESE_PATTERN.matcher(value).find();
if (containsChinese) {
// 含中文，按中文名算，10个字内
if (value.length() > 10) {
value = StringUtils.substring(value, 0, 7) + "...";
}
} else {
// 纯字母或符号，20个以内
if (value.length() > 20) {
value = StringUtils.substring(value, 0, 17) + "...";
}
}
} else if (StringUtils.startsWith(name, "phrase")) {
// phrase.DATA: 5个以内纯汉字
value = PHRASE_PATTERN.matcher(value).replaceAll("");
if (value.isEmpty()) {
value = "好";
}
if (value.length() > 5) {
value = StringUtils.substring(value, 0, 5);
}
}

datum.setValue(value);
return datum;
}

public String toJson() {
return WxMaGsonBuilder.create().toJson(this);
}
Expand Down