The Foundation Cracks: A Comprehensive Study on Bugs and Testing Practices in LLM Libraries

TL;DR

This study provides a detailed empirical analysis of bugs and testing practices in LLM libraries, revealing API misuse as the main root cause and highlighting gaps in current testing effectiveness.

Contribution

It offers the first comprehensive taxonomy of bug types and root causes in LLM libraries, along with an analysis of testing strategies and their limitations.

Findings

API misuse is the leading root cause of bugs.

Most bugs escape detection due to inadequate testing.

Predefined expected outputs are the most common testing strategy.

Abstract

Large Language Model (LLM) libraries have emerged as the foundational infrastructure powering today's AI revolution, serving as the backbone for LLM deployment, inference optimization, fine-tuning, and production serving across diverse applications. Despite their critical role in the LLM ecosystem, these libraries face frequent quality issues and bugs that threaten the reliability of AI systems built upon them. To address this knowledge gap, we present the first comprehensive empirical investigation into bug characteristics and testing practices in modern LLM libraries. We examine 313 bug-fixing commits extracted across two widely-adopted LLM libraries: HuggingFace Transformers and vLLM.Through rigorous manual analysis, we establish comprehensive taxonomies categorizing bug symptoms into 5 types and root causes into 14 distinct categories.Our primary discovery shows that API misuse has emerged as the predominant root cause (32.17%-48.19%), representing a notable transition from algorithm-focused defects in conventional deep learning frameworks toward interface-oriented problems. Additionally, we examine 7,748 test functions to identify 7 distinct test oracle categories employed in current testing approaches, with predefined expected outputs (such as specific tensors and text strings) being the most common strategy. Our assessment of existing testing effectiveness demonstrates that the majority of bugs escape detection due to inadequate test cases (41.73%), lack of test drivers (32.37%), and weak test oracles (25.90%). Drawing from these findings, we offer some recommendations for enhancing LLM library quality assurance.