Aspose.3D FOSS
TypeScript
Fehlerbehebungsleitfäden

Fehlerbehebungsleitfäden

Diese Seite behandelt die häufigsten Fehler, die bei der Verwendung von @aspose/3d in TypeScript- und Node.js-Projekten auftreten, mit Ursachen‑Erklärungen und geprüften Lösungen.

Fehler bei der Modulauflösung

Error: Cannot find module '@aspose/3d/formats/obj'

Ursache: Die Modulauflösungsstrategie von TypeScript unterstützt keine Node.js‑ähnlichen Sub‑Pfad‑Exporte (exports in package.json) es sei denn moduleResolution ist gesetzt auf node oder node16.

Lösung: Setze moduleResolution auf "node" in Ihrem tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true
  }
}

Wenn Sie TypeScript 5.x mit "module": "node16" oder "module": "nodenext", verwenden Sie "moduleResolution": "node16" um übereinzustimmen.

SyntaxError: Cannot use import statement in a module

Ursache: Der kompilierte JavaScript-Code wird ausgeführt mit require() Semantik, aber die Ausgabe enthält ES-Modul import Syntax; das passiert, wenn module ist eingestellt auf es2020 oder esnext aber die Node.js-Laufzeit erwartet CommonJS.

Beheben: Verwenden "module": "commonjs" in tsconfig.json und führen Sie die kompilierten .js Dateien mit node direkt:

{
  "compilerOptions": {
    "module": "commonjs",
    "outDir": "./dist"
  }
}

Dann kompilieren und ausführen:

npx tsc
node dist/main.js

Error: Cannot find module '@aspose/3d'

Ursache: Das Paket ist nicht installiert, oder node_modules ist veraltet.

Beheben:

npm install @aspose/3d

Überprüfen Sie die Installation:

node -e "const { Scene } = require('@aspose/3d'); console.log('OK', new Scene().constructor.name);"

Leere Szene nach dem Laden

Szene lädt, aber rootNode.childNodes ist leer

Ursache (1): Das Dateiformat legt alle Geometrie direkt auf rootNode.entity statt als Kindknoten. Das ist bei Einzel‑Mesh‑STL‑Dateien üblich.

Diagnose:

import { Scene, Mesh } from '@aspose/3d';

const scene = new Scene();
scene.open('model.stl');

// Check rootNode directly
if (scene.rootNode.entity) {
    console.log(`Root entity: ${scene.rootNode.entity.constructor.name}`);
}
console.log(`Child count: ${scene.rootNode.childNodes.length}`);

Behebung: Durchlaufen beginnend bei scene.rootNode sich selbst, nicht nur seine Kinder:

function visit(node: any): void {
    if (node.entity instanceof Mesh) {
        const m = node.entity as Mesh;
        console.log(`Mesh: ${m.controlPoints.length} vertices`);
    }
    for (const child of node.childNodes) {
        visit(child);
    }
}
visit(scene.rootNode);

Ursache (2): Der Dateipfad ist falsch oder die Datei hat eine Größe von Null Bytes. Prüfen Sie, ob die Datei existiert und nicht leer ist, bevor Sie sie aufrufen. open().

import * as fs from 'fs';

const path = 'model.obj';
if (!fs.existsSync(path)) throw new Error(`File not found: ${path}`);
const stat = fs.statSync(path);
if (stat.size === 0) throw new Error(`File is empty: ${path}`);

Materialliste ist nach dem OBJ-Laden leer

Ursache: Materialladen ist standardmäßig deaktiviert in ObjLoadOptions. Die Bibliothek lädt die Geometrie, ohne die .mtl Sidecar-Datei.

Lösung: Setzen enableMaterials = true:

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
const opts = new ObjLoadOptions();
opts.enableMaterials = true;
scene.open('model.obj', opts);

Stellen Sie außerdem sicher, dass die .mtl Datei befindet sich im selben Verzeichnis wie die .obj Datei, da die Bibliothek sie relativ zum .obj Pfad.

Format- und I/O-Fehler

openFromBuffer wirft einen nicht erkannten Formatfehler

Ursache: Der Pufferinhalt ist kein erkennbares Binärformat oder der Puffer ist beschädigt (abgeschnitten, falsche Kodierung oder Base64 anstelle von Rohbytes).

Diagnose:

const buffer = fs.readFileSync('model.glb');
console.log('Buffer size:', buffer.length, 'bytes');
console.log('First 4 bytes (hex):', buffer.slice(0, 4).toString('hex'));
// GLB magic: 676c5446 ("glTF")
// STL binary starts with 80 bytes of header; no fixed magic
// OBJ is text: openFromBuffer may not detect format

Lösung: Für textbasierte Formate (OBJ, COLLADA) übergeben Sie die entsprechende Optionsklasse, um das Format zu kennzeichnen:

import { ObjLoadOptions } from '@aspose/3d/formats/obj';
scene.openFromBuffer(buffer, new ObjLoadOptions());

Ausgabe-GLB öffnet sich als JSON in 3D-Viewern

Ursache: GltfSaveOptions.binaryMode standardmäßig auf false, erzeugt .gltf JSON-Ausgabe, selbst wenn der Ausgabedateiname .glb.

Lösung: Explizit festlegen binaryMode = true:

import { GltfSaveOptions } from '@aspose/3d/formats/gltf';

const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save('output.glb', opts);

STL-Ausgabe enthält im Slicer keine Farb- oder Materialdaten

Ursache: Das STL-Format unterstützt in seiner Standardspezifikation keine Materialien oder Farben. Farbunterstützende Slicer verwenden proprietäre Erweiterungen, die nicht unterstützt werden von @aspose/3d.

Lösung: Exportieren Sie stattdessen zu 3MF, das Farb- und Materialmetadaten unterstützt:

scene.save('output.3mf');

TypeScript-Kompilierungsfehler

Property 'controlPoints' does not exist on type 'Entity'

Ursache: Entity ist die Basisklasse; Mesh ist der konkrete Typ mit Geometrieeigenschaften. Sie benötigen ein instanceof Sicherheitsprüfung, bevor Sie auf mesh-spezifische Mitglieder zugreifen.

Lösung:

import { Mesh } from '@aspose/3d';

if (node.entity instanceof Mesh) {
    const mesh = node.entity as Mesh;
    console.log(mesh.controlPoints.length);
}

Type 'null' is not assignable to type 'Node'

Ursache: getChildNode() gibt zurück Node | null. Der strenge Modus von TypeScript erfordert, dass Sie den Null‑Fall behandeln.

Beheben:

const child = node.getChildNode('wheel');
if (!child) throw new Error('Node "wheel" not found');
// child is now Node, not null

Cannot find name 'GltfSaveOptions'

Ursache: GltfSaveOptions befindet sich im Sub-Pfad-Modul @aspose/3d/formats/gltf, nicht im Paket-Stamm.

Beheben: Importieren Sie aus dem Sub-Pfad:

import { GltfSaveOptions } from '@aspose/3d/formats/gltf';

Speicher- und Leistungsprobleme

Prozess läuft bei großen FBX-Dateien wegen Speichermangels

Ursache: Sehr große FBX-Dateien (>200 MB) belegen einen erheblichen Heap. Der Standard‑Heap von Node.js beträgt ~1.5 GB auf 64‑Bit‑Systemen, könnte aber für Multi‑Scene‑Dateien nicht ausreichen.

Beheben: Erhöhen Sie die Node.js‑Heap‑Größe:

node --max-old-space-size=8192 dist/convert.js

Verarbeite die Dateien außerdem sequenziell statt parallel, wenn der Speicher begrenzt ist:

for (const file of files) {
    const scene = new Scene();
    scene.open(file);
    scene.save(file.replace('.fbx', '.glb'));
    // scene goes out of scope; GC can reclaim
}

Siehe auch

 Deutsch