Android中Logcat长日志打印不全问题正解

前言: Android中Logcat长日志打印不全的问题很多人都知道,网上也有很多解决方案,但问题是这些答案确定是正解吗?

说一下我的经过:

  1. 最开始发现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++;
        }
    }
  1. 本以为很完美,但使用过程中还是老出现奇怪的问题,有的日志打印正常,有的日志打印却会丢失,这就让人很难受了,我一度以为是我打印日志过多,控制台选择性丢弃了部分日志,因为以前日志打印过多把控制台都搞崩溃过。

  2. 当有一次打印超长的一个json字符串,然后我分段复制出来拼接,但是一顿操作后却不能拼接成完整json,原因就是特么又有日志丢了,我那个气哦~(垃圾AS,毁我青春)唉,那再接再厉看看啥情况呗。

  3. 我就用控制变量法,反复测试打印速度、文本长度、文本内容等,在什么情况下会丢日志,最后发现就是上面代码的问题,AS控制台打印的最大长度不是按字符串长度算的,而字节长度!!!

  4. 为什么会偶尔丢日志?字符串默认是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);
    }

注意事项

  1. 日志打印为了保证性能,要减少调用字符串的getBytes()方法,这个方法会遍历字符串,将每个字符编码为不同的字节。
  2. 可根据需求添加一个次数限制,避免有非常长的日志一直打印,如果本身需要全部打印就忽略这个问题。

你可能感兴趣的:(Android中Logcat长日志打印不全问题正解)