Android开发报错：Attempt to invoke virtual method on a null object reference

嘿，看起来你碰到了Android开发里最常见的坑之一——空指针异常（NullPointerException）！结合你描述的PDF解析+TTS转音频功能，还有提到的代码部分，我帮你梳理几个最可能的排查方向：

你用到了synthesizeToFile方法，而TTS引擎的初始化是异步的，如果在初始化完成前就调用合成方法，大概率会触发空指针。

一定要在TextToSpeech.OnInitListener的回调里确认初始化成功后，再执行音频合成逻辑：

private TextToSpeech tts;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 初始化TTS引擎，必须等待回调确认成功
    tts = new TextToSpeech(this, status -> {
        if (status == TextToSpeech.SUCCESS) {
            // 先检查语言支持
            int langResult = tts.setLanguage(Locale.getDefault());
            if (langResult == TextToSpeech.LANG_MISSING_DATA || langResult == TextToSpeech.LANG_NOT_SUPPORTED) {
                Log.e("TTS", "当前语言不支持");
                return;
            }
            // 到这里才安全调用synthesizeToFile
            convertTextToAudio(extractedPdfText, getAudioOutputFile());
        } else {
            Log.e("TTS", "引擎初始化失败");
        }
    });
}

private File getAudioOutputFile() {
    // 确保保存目录存在，避免路径无效
    File audioDir = new File(getExternalFilesDir(null), "PdfAudio");
    if (!audioDir.exists()) audioDir.mkdirs();
    return new File(audioDir, "output.mp3");
}

用iText解析PDF时，如果PDF加密、内容为空，或者解析逻辑有漏洞，可能会返回null或空字符串。把null传给TTS合成方法，也会触发空指针。

建议在解析后加非空校验：

String extractedText = parsePdfContent(pdfFile);
// 先判断文本有效性
if (extractedText == null || extractedText.trim().isEmpty()) {
    Log.e("PDF解析", "提取的文本为空或解析失败");
    Toast.makeText(this, "PDF内容无法解析", Toast.LENGTH_SHORT).show();
    return;
}
// 再传给TTS处理

你提到了自定义适配器，这里也是空指针高发区，常见原因有：

• 数据源（比如List）未初始化就调用getCount()/getItem()
• findViewById找不到对应控件，返回null后调用控件方法（如setText）
• 传入的Context为null，后续用上下文做操作时出错

给你一个安全的适配器模板参考：

public class CustomAdapter extends BaseAdapter {
    private final Context mContext;
    private final List<String> mData;

    // 构造方法确保数据源和上下文非空
    public CustomAdapter(Context context, List<String> data) {
        this.mContext = context;
        this.mData = data != null ? data : new ArrayList<>(); // 避免数据源为null
    }

    @Override
    public int getCount() {
        return mData.size();
    }

    @Override
    public Object getItem(int position) {
        return mData.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder holder;
        if (convertView == null) {
            convertView = LayoutInflater.from(mContext).inflate(R.layout.item_pdf_list, parent, false);
            holder = new ViewHolder();
            // 确保控件ID与布局文件一致，避免findViewById返回null
            holder.pdfNameTv = convertView.findViewById(R.id.tv_pdf_name);
            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }
        // 先判空再操作控件
        if (holder.pdfNameTv != null) {
            holder.pdfNameTv.setText(mData.get(position));
        }
        return convertView;
    }

    static class ViewHolder {
        TextView pdfNameTv;
    }
}

如果指定的保存目录不存在，或者没有写入权限，synthesizeToFile可能会因为无法创建文件触发异常，甚至间接导致空指针：

• Android 6.0+需要动态申请WRITE_EXTERNAL_STORAGE权限（如果保存到外部存储）
• 提前创建目标目录，确保路径合法（推荐用getExternalFilesDir，不需要额外权限）

如果能把完整的错误日志（尤其是空指针发生的具体行号）贴出来，就能更精准定位问题啦！

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