Skip to main content
Contributions are welcome. Feel free to add more.

1. Context corruption with GLOO op.preamble.length <= op.nbytes in PD disaggregation

Error message

Cause

(Possibly, not precisely located) High-concurrency long sequences fill up the transfer buffer, causing buffer index collision and data corruption.

Solution

  1. Disable overlap on the Prefill node with --disable-overlap-schedule. The Prefill node in PD disaggregation must not enable overlap, otherwise it causes timing issues that lead to out-of-order reception on the Decode node.
  2. Even with overlap disabled, multi-Prefill node high-concurrency long-sequence scenarios may still encounter this issue with low probability. This is a known issue pending resolution.

2. Graph mode aclnnInplaceFillScalar error

Error message

Cause

Too many captured graphs cause a conflict in the graph mode update stream. Each graph is placed on a separate stream, but the number of streams is limited. If too many graphs are captured, conflicts occur.

Solution

  • CANN 8.5 + TorchNPU 2.8 should have resolved this issue.
  • If your versions do not match, reduce the number of captured graphs to 10 or fewer.

3. alloc_extend_kernel error

Error message

Error plog

Cause

The alloc_extend_kernel operator appears to have a memory allocation issue. Pending resolution.

Solution

Modify sglang/srt/hardware_backend/npu/allocator_npu.py to comment out the affected branch and use the else branch instead.

4. Out of NPU memory

Solution

First, use the npu-smi info command to check the NPU memory usage. If the NPUs are occupied by other processes, use --base-gpu-id to specify the starting device index. If the NPUs are not occupied, you can use --tp to deploy across multiple devices, or reduce the KV cache memory usage by increasing the --mem-fraction-static value. For detailed tuning guidance, see Hyperparameter Tuning.

5. How to update sgl-kernel-npu

Solution

6. [Errno 101] Network is unreachable when downloading HuggingFace datasets

Error message

Cause

The machine cannot directly access the HuggingFace server due to network restrictions (firewall, proxy, or regional access limitations).

Solution

  • Use an HF mirror site — set the HF_ENDPOINT environment variable to a mirror (e.g., hf-mirror.com):
  • Use a proxy — if you have an HTTP proxy available:
  • Download the dataset manually — use a machine with network access to download the file, then transfer it to the target machine. Use --dataset-path to specify the local file path:

7. Unexpected type fp8

Cause

FP8 model is not supported

Solution

Replace model weights, e.g., switch Qwen/Qwen3.5-27B-FP8 to Eco-Tech/Qwen3.5-27B-w8a8-mtp.

8. Docker image versions: stable release vs. daily build

Docker images for Ascend NPU are available in two types:
  • Stable release — validated version with a specific tag, e.g., quay.io/ascend/sglang:v0.5.13.post1-cann9.0.0-a3. Recommended for production deployments.
  • Daily build — includes the latest development changes, e.g., quay.io/ascend/sglang:main-cann8.5.0-a3. Use this if you need the latest features or bug fixes that have not yet been included in a stable release.
If you encounter issues with a stable release, try switching to a daily build to see if the issue has been resolved in the latest development version.