前言: Android中Logcat长日志打印不全的问题很多人都知道,网上也有很多解决方案,但问题是这些答案确定是正解吗?
说一下我的经过:
- 最开始发现Logcat长日志打印不全,然后我就去网上找了答案,很多文章说的是打印日志最长是4k长度的字符串,我用长英文字母的字符串测试后,大概代码是这样子的(错误代码):
/**
* 超4000字符时分段打印
*
* @param priority
* @param tag
* @param content
*/
private void print(int priority, String tag, String content) {
if (content == null) {
content = "";
}
// 不超过4000时正常打印
if (content.length() <= 4000) {
Log.println(priority, tag, content);
return;
}
int count = 1;
// 超过4000时分段打印
for (int i = 0; i < content.length(); i += 4000) {
String desc = String.format("分段打印(%s):", count);
String splitContent = i + 4000 < content.length() ? content.substring(i, i + 4000) : content.substring(i, content.length());
Log.println(priority, tag, desc + splitContent);
count++;
}
}
本以为很完美,但使用过程中还是老出现奇怪的问题,有的日志打印正常,有的日志打印却会丢失,这就让人很难受了,我一度以为是我打印日志过多,控制台选择性丢弃了部分日志,因为以前日志打印过多把控制台都搞崩溃过。
当有一次打印超长的一个json字符串,然后我分段复制出来拼接,但是一顿操作后却不能拼接成完整json,原因就是特么又有日志丢了,我那个气哦~(垃圾AS,毁我青春)唉,那再接再厉看看啥情况呗。
我就用控制变量法,反复测试打印速度、文本长度、文本内容等,在什么情况下会丢日志,最后发现就是上面代码的问题,AS控制台打印的最大长度不是按字符串长度算的,而字节长度!!!
为什么会偶尔丢日志?字符串默认是UTF-8编码,它是一种变长编码,一个字符用1~4个字节表示,数字、字母及其他符号字符用1个字节表示,中文字符用3个字节表示,所以偶尔有超长字符串,且包含多个中文等字符时,其长度就可能超过最大限制,导致打印丢失。
解决方案
经多次测试,控制台最多打印了4062个字节(不同版本等情况会稍有出入),总的来说打印4000个字节在不同情况都是稳妥的。做法就是分段打印,这里需要将字符串转字节数组,将字节数组分段,再重新转字符串依次打印输出。
正解代码实现
/**
* 打印日志到控制台(解决Android控制台丢失长日志记录)
*
* @param priority
* @param tag
* @param content
*/
public void print(int priority, String tag, String content) {
// 1. 测试控制台最多打印4062个字节,不同情况稍有出入(注意:这里是字节,不是字符!!)
// 2. 字符串默认字符集编码是utf-8,它是变长编码一个字符用1~4个字节表示
// 3. 这里字符长度小于1000,即字节长度小于4000,则直接打印,避免执行后续流程,提高性能哈
if (content.length() < 1000) {
Log.println(priority, tag, content);
return;
}
// 一次打印的最大字节数
int maxByteNum = 4000;
// 字符串转字节数组
byte[] bytes = content.getBytes();
// 超出范围直接打印
if (maxByteNum >= bytes.length) {
Log.println(priority, tag, content);
return;
}
// 分段打印计数
int count = 1;
// 在数组范围内,则循环分段
while (maxByteNum < bytes.length) {
// 按字节长度截取字符串
String subStr = cutStr(bytes, maxByteNum);
// 打印日志
String desc = String.format("分段打印(%s):%s", count++, subStr);
Log.println(priority, tag, desc);
// 截取出尚未打印字节数组
bytes = Arrays.copyOfRange(bytes, subStr.getBytes().length, bytes.length);
// 可根据需求添加一个次数限制,避免有超长日志一直打印
/*if (count == 10) {
break;
}*/
}
// 打印剩余部分
Log.println(priority, tag, String.format("分段打印(%s):%s", count, new String(bytes)));
}
/**
* 按字节长度截取字节数组为字符串
*
* @param bytes
* @param subLength
* @return
*/
public String cutStr(byte[] bytes, int subLength) {
// 边界判断
if (bytes == null || subLength < 1) {
return null;
}
// 超出范围直接返回
if (subLength >= bytes.length) {
return new String(bytes);
}
// 复制出定长字节数组,转为字符串
String subStr = new String(Arrays.copyOf(bytes, subLength));
// 避免末尾字符是被拆分的,这里减1使字符串保持完整
return subStr.substring(0, subStr.length() - 1);
}
以下为测试代码
public void test() {
JSONArray array = new JSONArray();
StringBuilder builder1 = new StringBuilder();
StringBuilder builder2 = new StringBuilder();
for (int i = 0; i < 1000; i++) {
array.put("好h哦~");
builder1.append("哈哈哦哦");
builder2.append("hello1024");
}
String json = array.toString();
String str1 = builder1.toString();
String str2 = builder2.toString();
// json打印了2581个字符,字节长度为4057,其余丢失
Log.i("defaultTag", json);
// str1打印了1352个字符,字节长度为4056,其余丢失
Log.i("defaultTag", str1);
// str2打印了4055个字符,字节长度为4055,其余丢失
Log.i("defaultTag", str2);
// 以下为分段打印,看是否有丢失日志
print(Log.INFO, "defaultTag", json);
print(Log.INFO, "defaultTag", str1);
print(Log.INFO, "defaultTag", str2);
}
注意事项
- 日志打印为了保证性能,要减少调用字符串的getBytes()方法,这个方法会遍历字符串,将每个字符编码为不同的字节。
- 可根据需求添加一个次数限制,避免有非常长的日志一直打印,如果本身需要全部打印就忽略这个问题。